{"id":164906,"date":"2025-05-19T10:33:50","date_gmt":"2025-05-19T17:33:50","guid":{"rendered":"https:\/\/blog.everpuredata.com\/?p=164906"},"modified":"2025-06-17T07:57:48","modified_gmt":"2025-06-17T14:57:48","slug":"sql-server-2025-streamlining-t-sql-snapshot-backups","status":"publish","type":"post","link":"https:\/\/blog.everpuredata.com\/fr\/purely-technical\/sql-server-2025-streamlining-t-sql-snapshot-backups\/","title":{"rendered":"Int\u00e9gration de l\u2019API REST T-SQL dans SQL Server 2025\u00a0: Rationalisation des sauvegardes de snapshots T-SQL"},"content":{"rendered":"\n
\n
\n
\n

Synth\u00e8se<\/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

Cet article a initialement \u00e9t\u00e9 publi\u00e9 sur le blog d\u2019Anthony Nocentino<\/a>. Elle a \u00e9t\u00e9 republi\u00e9e avec le cr\u00e9dit et le consentement de l\u2019auteur.<\/em><\/p>\n\n\n\n

Dans cet article, je vais vous pr\u00e9senter un script T-SQL qui cr\u00e9e des snapshots coh\u00e9rents avec les applications sur Pure Storage\u00ae <\/sup>FlashArray<\/a>\u2122<\/sup>, le tout depuis SQL Server, sans outils externes. SQL Server 2025 introduit une nouvelle fonctionnalit\u00e9 puissante\u00a0: la proc\u00e9dure sp_invoke_external_rest_endpoint<\/em> stock\u00e9e. Gr\u00e2ce \u00e0 cette am\u00e9lioration, il est plus facile que jamais d\u2019appeler des API REST directement depuis T-SQL. En combinant cette nouvelle fonctionnalit\u00e9 avec l\u2019API Pure Storage, nous pouvons orchestrer les op\u00e9rations de snapshot en toute transparence, sans outils ou scripts externes.<\/p>\n\n\n\n

Si vous avez suivi ma s\u00e9rie \u00ab\u00a0Utilisation de la sauvegarde par snapshot T-SQL\u00a0\u00bb,<\/a> vous savez que cette fonctionnalit\u00e9 offre des avantages consid\u00e9rables pour les environnements de bases de donn\u00e9es volumineux. Aujourd\u2019hui, nous verrons comment mettre en \u0153uvre cela directement dans T-SQL en tirant parti de la capacit\u00e9 de SQL Server \u00e0 appeler des points de terminaison REST externes, sans avoir besoin de PowerShell.<\/p>\n\n\n\n

Dans T-SQL, en tirant parti de la capacit\u00e9 de SQL Server \u00e0 appeler des points de terminaison REST externes, il n\u2019est pas n\u00e9cessaire d\u2019utiliser PowerShell.<\/p>\n\n\n\n

Vous pouvez acc\u00e9der \u00e0 l\u2019int\u00e9gralit\u00e9 du scriptici<\/a>.<\/strong><\/p>\n\n\n\n

\n\n\n\n

Activation du point de terminaison REST dans SQL Server 2025<\/h2>\n\n\n\n

Tout d\u2019abord, assurons-nous de pouvoir nous connecter \u00e0 des terminaux REST externes\u00a0:<\/p>\n\n\n\n

sp_configure 'external rest endpoint enabled', 1;\nRECONFIGURE WITH OVERRIDE;\n<\/code><\/pre>\n\n\n\n
Cela permet \u00e0 la fonctionnalit\u00e9 de point de terminaison REST de SQL Server, qui permet \u00e0 SQL Server d\u2019effectuer des appels sortants sur l\u2019API REST. Cela est essentiel pour se connecter \u00e0 l\u2019API de la baie FlashArray afin de d\u00e9clencher des snapshots.<\/p>\n\n\n\n
Il est important de noter que tous les terminaux sp_invoke_external_rest_endpoint<\/code>doivent utiliser HTTPS avec chiffrement TLS, et que le certificat doit \u00eatre approuv\u00e9 par le syst\u00e8me d\u2019exploitation sous-jacent h\u00e9bergeant l\u2019instance SQL Server.<\/p>\n\n\n\n
Authentification avec la baie FlashArray<\/h2>\n\n\n\n
Ensuite, nous \u00e9tablirons une session s\u00e9curis\u00e9e avec la baie FlashArray de Pure Storage \u00e0 l\u2019aide de la proc\u00e9dure sp_invoke_external_rest_endpoint<\/code>newstored de SQL Server 2025. Cette fonctionnalit\u00e9 repr\u00e9sente une avanc\u00e9e significative dans les capacit\u00e9s de SQL Server, ce qui nous permet de passer des appels d\u2019API REST directement depuis T-SQL sans script externe.<\/p>\n\n\n\n
Pour s’authentifier sur une baie FlashArray, nous soumettons d’abord un jetonAPI <\/a>avecles autorisations suffisantes pour le terminal de connexion de la baie FlashArray. Une fois l’authentification r\u00e9ussie, la baie FlashArray renvoie anx-auth-token<\/code>dans les en-t\u00eates de r\u00e9ponse, qui deviennent nos identifiants de session pour toutes les op\u00e9rations d’API ult\u00e9rieures de cette session. Ce mod\u00e8le d\u2019authentification par jeton offre un m\u00e9canisme s\u00e9curis\u00e9 et limit\u00e9 dans le temps pour les interactions API, tout en conservant une piste d\u2019audit claire des op\u00e9rations.<\/p>\n\n\n\n
Dans le code qui suit, nous ex\u00e9cuterons cette demande d\u2019authentification, puis extrayons lex-auth-token<\/code>de la r\u00e9ponse JSON pour cr\u00e9er nos en-t\u00eates d\u2019autorisation pour les appels d\u2019API REST suivants.<\/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
Gestion des erreurs et extraction des jetons<\/h2>\n\n\n\n
Ensuite, nous v\u00e9rifierons la r\u00e9ussite de la connexion et extrayons le jeton d\u2019authentification. Si le code de retour de la baie FlashArray n’est pas 0, nous imprimerons un message d’erreur et quitterons. En supposant un succ\u00e8s, nous lirons lex-auth-token<\/code>de la r\u00e9ponse de connexion. Notez que la cl\u00e9 de jeton doit inclure des guillemets doubles \u00ab\u00a0x-auth-token\u00a0\u00bb<\/code> pour garantir JSON_VALUE<\/code>une analyse correcte. Une fois extrait, nous utiliserons le jeton pour construire l\u2019en-t\u00eate d\u2019autorisation pour les appels d\u2019API REST ult\u00e9rieurs sur la baie.<\/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
Geler la base de donn\u00e9es pour snapshot<\/h2>\n\n\n\n
L’\u00e9tape cruciale est la suspension des I\/O d’\u00e9criture de la base de donn\u00e9es pour pr\u00e9parer le snapshot. Cette commande utilise la fonction de sauvegarde par snapshot T-SQL de SQL Server 2022 pour geler les op\u00e9rations d\u2019I\/O d\u2019\u00e9criture sur la base de donn\u00e9es. La base de donn\u00e9es reste lisible, mais les op\u00e9rations d\u2019\u00e9criture sont suspendues jusqu\u2019\u00e0 ce que nous terminions notre processus de snapshot. Nous obtenons ainsi un snapshot coh\u00e9rent avec les applications.<\/p>\n\n\n\n
ALTER DATABASE [TestDB1] SET SUSPEND_FOR_SNAPSHOT_BACKUP = ON\n<\/code><\/pre>\n\n\n\n
Prise de l\u2019instantan\u00e9 du stockage<\/h2>\n\n\n\n
Avec I\/O en \u00e9criture bloqu\u00e9es sur la base de donn\u00e9es, nous sommes pr\u00eats \u00e0 prendre un snapshot sur la baie FlashArray. L\u2019\u00e9tape suivante consiste \u00e0 appeler leendpointprotection-group-snapshots<\/code>REST RESTpour lancer une sauvegarde instantan\u00e9e du groupe de protection.<\/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
Ici, nous appelons l’API RESTprotection-group-snapshotsendpoint<\/code> de la baie FlashArray pour cr\u00e9er un snapshot d’un groupe de protection nomm\u00e9aen-sql-25-a-pg<\/code>. Le groupe de protection doit contenir tous les volumes o\u00f9 sont stock\u00e9s nos fichiers de base de donn\u00e9es. La baie FlashArray cr\u00e9e un snapshot ponctuel de tous les volumes de ce groupe de protection.<\/p>\n\n\n\n
Extraction du nom du snapshot et cr\u00e9ation de la sauvegarde<\/h2>\n\n\n\n
\u00c0 l’\u00e9tape suivante, nous extrayons le nom du snapshot de la r\u00e9ponse JSON de la baie FlashArray \u00e0 l’aide deJSON_VALUE(@response, '$.result.items[0].name').<\/code> Ce nom sera inclus dans la description du support de sauvegarde dans le cadre d\u2019une sauvegarde avec m\u00e9tadonn\u00e9es uniquement. Si la baie FlashArray renvoie un code de r\u00e9ussite (code de retour = 0), nous proc\u00e9dons \u00e0 la sauvegarde \u00e0 l\u2019aide de la commandeBACKUP DATABASE<\/code> et de l\u2019METADATA_ONLY<\/code>option. Cela cr\u00e9e un fichier de sauvegarde l\u00e9ger contenant uniquement les m\u00e9tadonn\u00e9es de la base de donn\u00e9es et une r\u00e9f\u00e9rence \u00e0 l’instantan\u00e9 FlashArray dans laMEDIADESCRIPTION<\/code>. Le stockage du nom du snapshot dans le MEDIADESCRIPTION facilite l’identification et la localisation du snapshot FlashArray correspondant lors de l’ex\u00e9cution d’une op\u00e9ration de restauration.<\/p>\n\n\n\n
Si l\u2019op\u00e9ration de snapshot \u00e9choue, nous enregistrons un message d\u2019erreur et d\u00e9bloquons imm\u00e9diatement la base de donn\u00e9es pour reprendre les I\/O d\u2019\u00e9criture 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
V\u00e9rification du journal d\u2019erreurs SQL Server<\/h2>\n\n\n\n
Pour v\u00e9rifier notre fonctionnement de sauvegarde, nous v\u00e9rifions le journal d\u2019erreurs SQL Server.<\/p>\n\n\n\n
Le journal d\u2019erreurs SQL Server confirme que la sauvegarde par snapshot de la base de donn\u00e9es TestDB1 a r\u00e9ussi uniquement avec les m\u00e9tadonn\u00e9es. Le journal indique que la base de donn\u00e9es a \u00e9t\u00e9 suspendue, que les I\/O en \u00e9criture ont \u00e9t\u00e9 gel\u00e9es et que l\u2019instantan\u00e9 a \u00e9t\u00e9 pris avant que les I\/O ne reprennent en toute s\u00e9curit\u00e9. Puisqu\u2019il s\u2019agit d\u2019une sauvegarde avec m\u00e9tadonn\u00e9es uniquement, aucune page de donn\u00e9es n\u2019a \u00e9t\u00e9 trait\u00e9e\u00a0; seules les m\u00e9tadonn\u00e9es ont \u00e9t\u00e9 captur\u00e9es et \u00e9crites dans le fichier.bkm<\/code> sp\u00e9cifi\u00e9. Cela garantit un snapshot coh\u00e9rent avec les applications, avec un impact minimal sur la disponibilit\u00e9 de la base de donn\u00e9es.<\/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
Voici le r\u00e9sultat des d\u00e9clarations imprim\u00e9es que nous avons utilis\u00e9es ci-dessus. La sauvegarde des snapshots s’est termin\u00e9e avec succ\u00e8s\u00a0: le syst\u00e8me s’est authentifi\u00e9 avec la baie FlashArray, a suspendu TestDB1 pour geler les I\/O, a cr\u00e9\u00e9 le snapshot (aen-sql-25-a-pg.17),<\/code> a repris les I\/O et a fini par une sauvegarde uniquement bas\u00e9e sur les m\u00e9tadonn\u00e9es, le tout confirm\u00e9 par les journaux SQL Server et les r\u00e9ponses 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
Conclusion<\/h2>\n\n\n\n
Cet exemple montre comment la nouvelle sp_invoke_external_rest_endpoint<\/code>proc\u00e9dure de SQL Server 2025 transforme l\u2019automatisation des sauvegardes. Auparavant, l\u2019int\u00e9gration aux syst\u00e8mes de stockage n\u00e9cessitait PowerShell ou des outils externes. D\u00e9sormais, nous pouvons passer des appels d\u2019API REST en natif \u00e0 partir de T-SQL, ce qui simplifie les flux de travail et r\u00e9duit la complexit\u00e9.<\/p>\n\n\n\n
Principaux avantages\u00a0:<\/p>\n\n\n\n