{"id":164905,"date":"2025-05-19T10:33:50","date_gmt":"2025-05-19T17:33:50","guid":{"rendered":"https:\/\/blog.everpuredata.com\/?p=164905"},"modified":"2025-06-17T07:58:23","modified_gmt":"2025-06-17T14:58:23","slug":"sql-server-2025-streamlining-t-sql-snapshot-backups","status":"publish","type":"post","link":"https:\/\/blog.everpuredata.com\/es\/purely-technical\/sql-server-2025-streamlining-t-sql-snapshot-backups\/","title":{"rendered":"Integraci\u00f3n de la API REST T-SQL en SQL Server 2025: Optimizaci\u00f3n de las copias de seguridad de las copias instant\u00e1neas de T-SQL"},"content":{"rendered":"\n
\n
\n
\n

Resumen<\/h3>\n\n\n\n

This article takes you through the steps for using a T-SQL script to create application-consistent snapshots on <\/sup>FlashArray from within SQL Server, without needing any external tools or scripts.\u00a0<\/p>\n<\/div>\n\n\n\n

\"image_pdf\"<\/a>\"image_print\"<\/a><\/div>\n<\/div>\n\n\n\n
\n

Este art\u00edculo apareci\u00f3 originalmente en el blog de Anthony Nocentino<\/a>. Se ha vuelto a publicar con el reconocimiento y el consentimiento del autor.<\/em><\/p>\n\n\n\n

En esta publicaci\u00f3n, le guiar\u00e9 a trav\u00e9s de un script T-SQL que crea copias instant\u00e1neas coherentes con las aplicaciones en FlashArray<\/a>\u2122<\/sup> de Pure Storage\u00ae<\/sup>, todo ello desde SQL Server, sin herramientas externas. SQL Server 2025 presenta una nueva y potente caracter\u00edstica: el procedimiento sp_invoke_external_rest_endpoint<\/em> almacenado. Esta mejora hace que sea m\u00e1s f\u00e1cil que nunca llamar a las API REST directamente desde T-SQL. Al combinar esta nueva capacidad con la API de Pure Storage, podemos orquestar las operaciones de snapshots sin problemas \u2014sin necesidad de herramientas o scripts externos\u2014.<\/p>\n\n\n\n

Si ha seguido mi serie \u00abUso de copias de seguridad instant\u00e1neas de T-SQL\u00bb,<\/a> sabe que esta funci\u00f3n ofrece unas ventajas enormes para los entornos de bases de datos grandes. Hoy veremos c\u00f3mo implementarlo directamente en T-SQL aprovechando la capacidad de SQL Server para llamar a los puntos de conexi\u00f3n REST externos, sin necesidad de PowerShell.<\/p>\n\n\n\n

ectamente en T-SQL, al aprovechar la capacidad de SQL Server para llamar a los terminales REST externos, no se necesita PowerShell.<\/p>\n\n\n\n

Puede coger todo el scriptaqu\u00ed<\/a>.<\/strong><\/p>\n\n\n\n

\n\n\n\n

Habilitaci\u00f3n del punto final REST en SQL Server 2025<\/h2>\n\n\n\n

En primer lugar, vamos a asegurarnos de que podemos conectarnos a los puntos de conexi\u00f3n REST externos:<\/p>\n\n\n\n

sp_configure 'external rest endpoint enabled', 1;\nRECONFIGURE WITH OVERRIDE;\n<\/code><\/pre>\n\n\n\n
Esto permite que la funci\u00f3n de punto final REST de SQL Server, que permite que nuestro servidor SQL realice llamadas salientes a la API REST. Esto es crucial para conectarse a la API de FlashArray para activar las copias instant\u00e1neas.<\/p>\n\n\n\n
Es importante tener en cuenta sp_invoke_external_rest_endpoint<\/code>querequiere que todos los terminales utilicen HTTPS con cifrado TLS y el certificado debe ser de confianza para el sistema operativo subyacente que aloja la instancia de SQL Server.<\/p>\n\n\n\n
Autenticaci\u00f3n con FlashArray<\/h2>\n\n\n\n
A continuaci\u00f3n, estableceremos una sesi\u00f3n segura con FlashArray de Pure Storage usando el nuevoprocedimiento sp_invoke_external_rest_endpoint<\/code>de almacenamiento de SQL Server 2025. Esta caracter\u00edstica representa un avance significativo en las capacidades de SQL Server, lo que nos permite realizar llamadas a la API REST directamente desde T-SQL sin scripts externos.<\/p>\n\n\n\n
Para autenticarnos en una FlashArray, primero enviamos untoken API <\/a>conpermisos suficientes al punto de conexi\u00f3n de inicio de sesi\u00f3n de la FlashArray. Tras la autenticaci\u00f3n correcta, FlashArray devuelve anx-auth-token<\/code>en los encabezados de respuesta, que se convierten en nuestra credencial de sesi\u00f3n para todas las operaciones posteriores de la API en esta sesi\u00f3n. Este modelo de autenticaci\u00f3n basado en token proporciona un mecanismo seguro y con un tiempo limitado para las interacciones API, manteniendo al mismo tiempo un registro de auditor\u00eda claro de las operaciones.<\/p>\n\n\n\n
En el c\u00f3digo siguiente, ejecutaremos esta solicitud de autenticaci\u00f3n y luego extraeremos eltokenx-authde<\/code> la respuesta JSON para crear nuestros encabezados de autorizaci\u00f3n para las llamadas posteriores a la API REST.<\/p>\n\n\n\n
DECLARE @ret INT, @response NVARCHAR(MAX), @AuthToken NVARCHAR(100), @MyHeaders NVARCHAR(100);\n\nEXEC @ret = sp_invoke_external_rest_endpoint\n @url = N'https:\/\/flasharray1.purestorage.com\/api\/2.36\/login',\n @headers = N'{\"api-token\":\"PASTE_YOUR_TOKEN_HERE\"}',\n @response = @response OUTPUT;\n\nPRINT 'Login Return Code: ' + CAST(@ret AS NVARCHAR(10))\nPRINT 'Login Response: ' + @response\n<\/code><\/pre>\n\n\n\n
Gesti\u00f3n de errores y extracci\u00f3n de tokens<\/h2>\n\n\n\n
Luego, verificaremos el \u00e9xito del inicio de sesi\u00f3n y extraeremos el token de autenticaci\u00f3n. Si el c\u00f3digo de devoluci\u00f3n de FlashArray es distinto de 0, imprimiremos un mensaje de error y saldremos. Asumiendo el \u00e9xito, leeremos eltokenx-authde<\/code> la respuesta de inicio de sesi\u00f3n. Tenga en cuenta que la clave de token debe incluir comillas dobles\"x-auth-token\"<\/code>para garantizar JSON_VALUE<\/code>quepuede analizarse correctamente. Una vez extra\u00eddo, usaremos el token para construir el encabezado de autorizaci\u00f3n para las llamadas posteriores a la API REST a la cabina.<\/p>\n\n\n\n
if ( @ret <> 0 )\n    BEGIN\n        PRINT 'Error in REST call, unable to login to the array.'\n        RETURN\n    END\n\nSET @AuthToken = JSON_VALUE(@response, '$.response.headers.\"x-auth-token\"'); \nSET @MyHeaders = N'{\"x-auth-token\":\"' + @AuthToken + '\", \"Content-Type\":\"application\/json\"}'\n\nPRINT 'Headers: ' + @MyHeaders\n<\/code><\/pre>\n\n\n\n
Congelaci\u00f3n de la base de datos para las copias instant\u00e1neas<\/h2>\n\n\n\n
El paso crucial es suspender la I\/O de escritura de la base de datos para prepararse para la copia instant\u00e1nea. Este comando utiliza la funci\u00f3n de copia de seguridad instant\u00e1nea T-SQL de SQL Server 2022 para congelar las operaciones de I\/O escritura en la base de datos. La base de datos sigue siendo legible, pero las operaciones de escritura se suspenden hasta que completamos nuestro proceso de snapshot. Esto garantiza que obtenemos una copia instant\u00e1nea coherente con las aplicaciones.<\/p>\n\n\n\n
ALTER DATABASE [TestDB1] SET SUSPEND_FOR_SNAPSHOT_BACKUP = ON\n<\/code><\/pre>\n\n\n\n
Toma de la instant\u00e1nea del almacenamiento<\/h2>\n\n\n\n
Con I\/O de escritura congeladas en la base de datos, estamos listos para tomar una instant\u00e1nea en FlashArray. El siguiente paso es llamar al endpointprotection-group-snapshots<\/code>REST RESTpara iniciar una copia de seguridad instant\u00e1nea del grupo de protecci\u00f3n.<\/p>\n\n\n\n
EXEC @ret = sp_invoke_external_rest_endpoint\n @url = N'https:\/\/flasharray1.purestorage.com\/api\/2.36\/protection-group-snapshots',\n @headers = @MyHeaders,\n @payload = N'{\"source_names\":\"aen-sql-25-a-pg\"}',    \n @response = @response OUTPUT;\n\nPRINT 'Snapshot Return Code: ' + CAST(@ret AS NVARCHAR(10))\nPRINT 'Snapshot Response: ' + @response\n<\/code><\/pre>\n\n\n\n
Aqu\u00ed llamamos al punto final de la API RESTprotection-group-snapshotsendpoint<\/code> de FlashArray para crear una copia instant\u00e1nea de un grupo de protecci\u00f3n llamadoaen-sql-25-a-pg<\/code>. El grupo de protecci\u00f3n tiene que contener todos los vol\u00famenes en los que se almacenan nuestros archivos de base de datos. La FlashArray crear\u00e1 una copia instant\u00e1nea puntual de todos los vol\u00famenes de este grupo de protecci\u00f3n.<\/p>\n\n\n\n
Extracci\u00f3n del nombre de la instant\u00e1nea y creaci\u00f3n de la copia de seguridad<\/h2>\n\n\n\n
En el siguiente paso, extraemos el nombre de la copia instant\u00e1nea de la respuesta JSON de FlashArray usandoJSON_VALUE(@response, '$.result.items[0].name').<\/code> Este nombre se incluir\u00e1 en la Descripci\u00f3n de los medios de copia de seguridad como parte de una copia de seguridad solo de metadatos. Si FlashArray devuelve un c\u00f3digo de \u00e9xito (c\u00f3digo de devoluci\u00f3n = 0), procederemos con la copia de seguridad usando el comandoBASEDA DE COPIA DE SEGURIDAD<\/code> y METADATA_ONLY<\/code>laopci\u00f3n. Esto crea un archivo de copia de seguridad ligero que contiene solo los metadatos de la base de datos y una referencia a la copia instant\u00e1nea de FlashArray enMEDIADESCRIPTION<\/code>. El almacenamiento del nombre de la copia instant\u00e1nea en MEDIADESCRIPTION facilita la identificaci\u00f3n y la localizaci\u00f3n de la copia instant\u00e1nea de FlashArray correspondiente cuando se realiza una operaci\u00f3n de restauraci\u00f3n.<\/p>\n\n\n\n
Si la operaci\u00f3n de la copia instant\u00e1nea falla, registramos un mensaje de error y cancelamos inmediatamente la suspensi\u00f3n de la base de datos para reanudar las I\/O de escritura normales.<\/p>\n\n\n\n
DECLARE @SnapshotName NVARCHAR(100)\nSET @SnapshotName = JSON_VALUE(@response, '$.result.items[0].name')\n\nif ( @ret = 0 ) \n    BEGIN\n        BACKUP DATABASE [TestDB1] TO DISK='SnapshotBack.bkm' WITH METADATA_ONLY, MEDIADESCRIPTION=@SnapshotName\n        PRINT 'Snapshot backup successful. Snapshot Name: ' + @SnapshotName\n    END\nELSE \n    BEGIN\n        ALTER DATABASE [TestDB1] SET SUSPEND_FOR_SNAPSHOT_BACKUP = OFF\n        PRINT 'Error in REST call, snapshot backup failed. Database unsuspended.'\n    END\n<\/code><\/pre>\n\n\n\n
Comprobaci\u00f3n del registro de errores de SQL Server<\/h2>\n\n\n\n
Para verificar el funcionamiento de nuestras copias de seguridad, comprobamos el registro de errores de SQL Server.<\/p>\n\n\n\n
El registro de errores de SQL Server confirma que la copia de seguridad de la copia instant\u00e1nea de la base de datos de TestDB1 solo tiene \u00e9xito con los metadatos. El registro muestra que la base de datos se ha suspendido, que la I\/O de escritura se ha congelado y que la copia instant\u00e1nea se ha tomado antes de que se reanudara I\/O manera segura. Como se trata de una copia de seguridad solo de metadatos, no se procesaron p\u00e1ginas de datos; solo se capturaron metadatos y se escribieron en el archivo specified.bkm<\/code>. Esto garantiza una copia instant\u00e1nea coherente con la aplicaci\u00f3n, con un impacto m\u00ednimo en la disponibilidad de la base de datos.<\/p>\n\n\n\n
EXEC xp_readerrorlog 0, 1, NULL, NULL, NULL, NULL, N'desc'\n\n2025-05-09 12:03:25.120 Backup  BACKUP DATABASE successfully processed 0 pages in 0.004 seconds (0.000 MB\/sec).\n2025-05-09 12:03:25.090 Backup  Database backed up. Database: TestDB1, creation date(time): 2025\/04\/30(16:05:02), pages dumped: 394061770, first LSN: 80323:19757:39, last LSN: 80323:19774:1, number of dump devices: 1, device information: (FILE=12, TYPE=DISK: {'C:\\Program Files\\Microsoft SQL Server\\MSSQL17.MSSQLSERVER\\MSSQL\\Backup\\SnapshotBack.bkm'}). This is an informational message only. No user action is required.\n2025-05-09 12:03:25.080 spid86  Database 'TestDB1' originally suspended for snapshot backup in session 86 successfully resumed in session 86.\n2025-05-09 12:03:25.080 spid86  Database 'TestDB1' released suspend locks in session 86.\n2025-05-09 12:03:25.080 spid86  I\/O was resumed on database TestDB1. No user action is required.\n2025-05-09 12:03:25.080 spid86  I\/O is frozen on database TestDB1. No user action is required. However, if I\/O is not resumed promptly, you could cancel the backup.\n2025-05-09 12:03:22.110 spid86  Database 'TestDB1' successfully suspended for snapshot backup in session 86.\n2025-05-09 12:03:22.110 spid86  I\/O is frozen on database TestDB1. No user action is required. However, if I\/O is not resumed promptly, you could cancel the backup.\n2025-05-09 12:03:22.070 spid86  Database 'TestDB1' acquired suspend locks in session 86.\n2025-05-09 12:03:22.070 spid86  Setting database option suspend_for_snapshot_backup to ON for database 'TestDB1'.\n<\/code><\/pre>\n\n\n\n
Este es el resultado de las declaraciones impresas que hemos utilizado anteriormente. La copia de seguridad de la copia instant\u00e1nea se complet\u00f3 correctamente: el sistema se autentic\u00f3 con FlashArray, suspendi\u00f3 TestDB1 para congelar I\/O, cre\u00f3 la copia instant\u00e1nea (aen-sql-25-a-pg.17),<\/code> reanud\u00f3 I\/O y termin\u00f3 con una copia de seguridad solo de metadatos \u2014 todo confirmado mediante registros de SQL Server y respuestas de API.<\/p>\n\n\n\n
Login Return Code: 0\nLogin Response: {\"response\":{\"status\":{\"http\":{\"code\":200,\"description\":\"\"}},\"headers\":{\"Date\":\"Fri, 09 May 2025 12:03:22 GMT\",\"Content-Length\":\"37\",\"Content-Type\":\"application\\\/json\",\"Server\":\"nginx\",\"x-auth-token\":\"75b2b984-a238-44ce-adbd-ff19decab148\",\"strict-transport-security\":\"max-age=31536000; includeSubDomains;\",\"content-security-policy\":\"frame-ancestors 'none'\",\"x-frame-options\":\"DENY\",\"x-content-type-options\":\"nosniff\",\"x-xss-protection\":\"1; mode=block\",\"x-request-id\":\"bdc6bbff70105c00fdeac8b0a1af565c\"}},\"result\":{\"items\":[{\"username\":\"anocentino\"}]}}\n\nHeaders: {\"x-auth-token\":\"75b2b984-a238-44ce-adbd-ff19decab148\", \"Content-Type\":\"application\/json\"}\n\nDatabase 'TestDB1' acquired suspend locks in session 86.\nI\/O is frozen on database TestDB1. No user action is required. However, if I\/O is not resumed promptly, you could cancel the backup.\nDatabase 'TestDB1' successfully suspended for snapshot backup in session 86.\n\nSnapshot Return Code: 0\nSnapshot Response: {\"response\":{\"status\":{\"http\":{\"code\":200,\"description\":\"\"}},\"headers\":{\"Date\":\"Fri, 09 May 2025 12:03:22 GMT\",\"Content-Length\":\"340\",\"Content-Type\":\"application\\\/json\",\"Server\":\"nginx\",\"x-auth-token\":\"75b2b984-a238-44ce-adbd-ff19decab148\",\"strict-transport-security\":\"max-age=31536000; includeSubDomains;\",\"content-security-policy\":\"frame-ancestors 'none'\",\"x-frame-options\":\"DENY\",\"x-content-type-options\":\"nosniff\",\"x-xss-protection\":\"1; mode=block\",\"x-request-id\":\"e3089939224baca84d6ad69b485855de\"}},\"result\":{\"items\":[{\"name\":\"aen-sql-25-a-pg.17\",\"id\":\"32e86de3-a3ee-3ae0-f74c-4bf5a7f74744\",\"space\":null,\"source\":{\"name\":\"aen-sql-25-a-pg\",\"id\":\"b6660b61-a8de-ae1b-cb65-e3045d13b5ba\"},\"suffix\":\"17\",\"destroyed\":false,\"created\":1746792202183,\"pod\":{\"name\":null,\"id\":null},\"time_remaining\":null,\"eradication_config\":{\"manual_eradication\":\"enabled\"}}]}}\n\nI\/O was resumed on database TestDB1. No user action is required.\nDatabase 'TestDB1' released suspend locks in session 86.\nDatabase 'TestDB1' originally suspended for snapshot backup in session 86 successfully resumed in session 86.\nProcessed 0 pages for database 'TestDB1', file 'test_data_01' on file 12.\nProcessed 0 pages for database 'TestDB1', file 'test_data_02' on file 12.\nProcessed 0 pages for database 'TestDB1', file 'test_data_03' on file 12.\nProcessed 0 pages for database 'TestDB1', file 'test_data_04' on file 12.\nProcessed 0 pages for database 'TestDB1', file 'test_data_05' on file 12.\nProcessed 0 pages for database 'TestDB1', file 'test_data_06' on file 12.\nProcessed 0 pages for database 'TestDB1', file 'test_data_07' on file 12.\nProcessed 0 pages for database 'TestDB1', file 'test_data_08' on file 12.\nBACKUP DATABASE successfully processed 0 pages in 0.004 seconds (0.000 MB\/sec).\n\nSnapshot backup successful. Snapshot Name: aen-sql-25-a-pg.17\n<\/code><\/pre>\n\n\n\n
Conclusi\u00f3n de las cosas<\/h2>\n\n\n\n
Este ejemplo destaca el modo en que el sp_invoke_external_rest_endpoint<\/code>nuevoprocedimiento de SQL Server 2025 transforma la automatizaci\u00f3n de las copias de seguridad. Anteriormente, la integraci\u00f3n con los sistemas de almacenamiento requer\u00eda PowerShell o herramientas externas. Ahora, podemos realizar llamadas a la API REST de manera nativa desde T-SQL, lo que agiliza los flujos de trabajo y reduce las complejidades.<\/p>\n\n\n\n
Ventajas clave:<\/p>\n\n\n\n