{"id":164907,"date":"2025-05-19T10:33:50","date_gmt":"2025-05-19T17:33:50","guid":{"rendered":"https:\/\/blog.everpuredata.com\/?p=164907"},"modified":"2025-06-17T07:58:56","modified_gmt":"2025-06-17T14:58:56","slug":"sql-server-2025-streamlining-t-sql-snapshot-backups","status":"publish","type":"post","link":"https:\/\/blog.everpuredata.com\/le\/purely-technical\/sql-server-2025-streamlining-t-sql-snapshot-backups\/","title":{"rendered":"Integraci\u00f3n de REST REST API T-SQL en SQL Server 2025: Optimizaci\u00f3n de las copias de seguridad de snapshots 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 cr\u00e9dito y consentimiento del autor.<\/em><\/p>\n\n\n\n

En esta publicaci\u00f3n, lo guiar\u00e9 a trav\u00e9s de un gui\u00f3n de T-SQL que crea snapshots consistentes con la aplicaci\u00f3n en Pure Storage\u00ae <\/sup>FlashArray<\/a>\u2122<\/sup>, todo desde SQL Server, sin herramientas externas. SQL Server 2025 presenta una nueva funci\u00f3n potente: el procedimiento sp_invoke_external_rest_endpoint<\/em> almacenado. Esta mejora hace que sea m\u00e1s f\u00e1cil que nunca llamar a las API de REST directamente desde T-SQL. Al combinar esta nueva capacidad con la API de Pure Storage, podemos organizar las operaciones de snapshots sin problemas, sin necesidad de herramientas externas ni scripts.<\/p>\n\n\n\n

Si ha estado siguiendo mi serie \u201cUso de la copia de seguridad de snapshots T-SQL\u201d,<\/a> sabe que esta funci\u00f3n ofrece enormes beneficios para entornos de bases de datos grandes. Hoy, analizaremos c\u00f3mo implementar esto directamente en T-SQL al aprovechar la capacidad de SQL Server para llamar a los puntos finales 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 puntos finales REST externos, no se requiere PowerShell.<\/p>\n\n\n\n

Puede tomar todo el gui\u00f3naqu\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

Primero, asegur\u00e9monos de que podamos conectarnos a puntos finales 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 habilita la funci\u00f3n de punto final REST de SQL Server, que permite que nuestro SQL Server realice llamadas salientes a la API REST. Esto es fundamental para conectarse a la API de FlashArray para activar snapshots.<\/p>\n\n\n\n
Es importante tener en cuenta sp_invoke_external_rest_endpoint<\/code>querequiere que todos los puntos finales usen HTTPS con cifrado TLS, y el certificado debe ser confiable por 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 utilizando el nuevo procedimiento sp_invoke_external_rest_endpoint<\/code>almacenado de SQL Server 2025. Esta funci\u00f3n representa un avance significativo en las capacidades de SQL Server, lo que nos permite realizar llamadas de REST API directamente desde T-SQL sin secuencias de comandos externas.<\/p>\n\n\n\n
Para autenticar un FlashArray, primero enviamos untoken API <\/a>conpermisos suficientes al punto final de inicio de sesi\u00f3n de FlashArray. Tras la autenticaci\u00f3n exitosa, FlashArray devuelve un token de autenticaci\u00f3n en<\/code> los encabezados de respuesta, lo que se convierte en nuestra credencial de sesi\u00f3n para todas las operaciones de API posteriores en esta sesi\u00f3n. Este modelo de autenticaci\u00f3n basado en tokens proporciona un mecanismo seguro y limitado por tiempo para las interacciones de API mientras mantiene un seguimiento de auditor\u00eda claro de las operaciones.<\/p>\n\n\n\n
En el siguiente c\u00f3digo, ejecutaremos esta solicitud de autenticaci\u00f3n y luego extraeremos el token de autorizaci\u00f3n de<\/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
Manejo de errores y extracci\u00f3n de tokens<\/h2>\n\n\n\n
A continuaci\u00f3n, verificaremos el \u00e9xito del inicio de sesi\u00f3n y extraeremos el token de autenticaci\u00f3n. Si el c\u00f3digo de devoluci\u00f3n de FlashArray no es 0, imprimiremos un mensaje de error y saldremos. Asumiendo el \u00e9xito, leeremos eltoken de autorizaci\u00f3n de la respuesta<\/code> 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>que pueda analizarse correctamente. Una vez extra\u00eddo, usaremos el token para construir el encabezado de autorizaci\u00f3n para las llamadas posteriores de REST API a la matriz.<\/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 snapshots<\/h2>\n\n\n\n
El paso crucial viene: suspender la I\/O de escritura de la base de datos para prepararse para la instant\u00e1nea. Este comando utiliza la funci\u00f3n de copia de seguridad de snapshots T-SQL de SQL Server 2022 para congelar las operaciones de I\/O de 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 obtengamos una instant\u00e1nea consistente con la aplicaci\u00f3n.<\/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 de almacenamiento<\/h2>\n\n\n\n
Con I\/O escritura congelada en la base de datos, estamos listos para tomar una instant\u00e1nea en FlashArray. El siguiente paso es llamar al punto finalprotection-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 snapshots del grupo de protecci\u00f3n<\/code> de API REST de FlashArray para crear una instant\u00e1nea de un grupo de protecci\u00f3n llamadoaen-sql-25-a-pg<\/code>. El grupo de protecci\u00f3n debe contener todos los vol\u00famenes donde se almacenan los archivos de nuestra base de datos. FlashArray crear\u00e1 una instant\u00e1nea en un momento determinado de todos los vol\u00famenes de este grupo de protecci\u00f3n.<\/p>\n\n\n\n
Extraer el nombre de la instant\u00e1nea y crear la copia de seguridad<\/h2>\n\n\n\n
En el siguiente paso, extraemos el nombre de la 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 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 comandoBACKUP DATABASE<\/code> y la METADATA_ONLY<\/code>opci\u00f3n. Esto crea un archivo de copia de seguridad liviano que contiene solo los metadatos de la base de datos y una referencia a la snapshot de FlashArray en MEDIADESCRIPTION<\/code>. Al almacenar el nombre de la snapshot en MEDIADESCRIPTION, es m\u00e1s f\u00e1cil identificar y ubicar la snapshot de FlashArray correspondiente cuando se realiza una operaci\u00f3n de restauraci\u00f3n.<\/p>\n\n\n\n
Si la operaci\u00f3n de snapshot falla, registramos un mensaje de error y dessuspendemos inmediatamente la base de datos para reanudar la I\/O escritura normal.<\/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
Verificaci\u00f3n del registro de errores de SQL Server<\/h2>\n\n\n\n
Para verificar nuestra operaci\u00f3n de copia de seguridad, verificamos el registro de errores de SQL Server.<\/p>\n\n\n\n
El registro de errores de SQL Server confirma una copia de seguridad exitosa de la base de datos TestDB1 solo para metadatos. El registro muestra que la base de datos se suspendi\u00f3, la I\/O escritura se congel\u00f3 y la instant\u00e1nea se tom\u00f3 antes de que se reanudara la I\/O de manera segura. Dado que esta es una copia de seguridad solo de metadatos, no se procesaron p\u00e1ginas de datos; solo se capturaron y escribieron metadatos en el archivo.bkm<\/code> especificado. Esto garantiza una instant\u00e1nea consistente 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 usamos anteriormente. La copia de seguridad de la snapshot se complet\u00f3 correctamente: el sistema se autentic\u00f3 con FlashArray, suspendi\u00f3 TestDB1 para congelar I\/O, cre\u00f3 la snapshot (aen-sql-25-a-pg.17),<\/code> reanud\u00f3 I\/O y finaliz\u00f3 con una copia de seguridad solo de metadatos, todo confirmado a trav\u00e9s de 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
Resumen de las cosas<\/h2>\n\n\n\n
Este ejemplo destaca c\u00f3mo el nuevo sp_invoke_external_rest_endpoint<\/code>procedimiento de SQL Server 2025transforma la automatizaci\u00f3n de la copia de seguridad. Anteriormente, la integraci\u00f3n con los sistemas de almacenamiento requer\u00eda PowerShell o herramientas externas. Ahora, podemos realizar llamadas de REST API de forma nativa desde T-SQL, lo que agiliza los flujos de trabajo y reduce la complejidad.<\/p>\n\n\n\n
Beneficios clave:<\/p>\n\n\n\n