{"id":164909,"date":"2025-05-19T10:33:50","date_gmt":"2025-05-19T17:33:50","guid":{"rendered":"https:\/\/blog.everpuredata.com\/?p=164909"},"modified":"2025-06-17T07:58:01","modified_gmt":"2025-06-17T14:58:01","slug":"sql-server-2025-streamlining-t-sql-snapshot-backups","status":"publish","type":"post","link":"https:\/\/blog.everpuredata.com\/it\/purely-technical\/sql-server-2025-streamlining-t-sql-snapshot-backups\/","title":{"rendered":"Integrazione delle API REST T-SQL in SQL Server 2025: Semplificazione dei backup delle snapshot T-SQL"},"content":{"rendered":"\n
\n
\n
\n

Sintesi<\/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

Questo articolo \u00e8 apparso originariamente sul blog di Anthony Nocentino<\/a>. \u00c8 stato ripubblicato con il credito e il consenso dell’autore.<\/em><\/p>\n\n\n\n

In questo post ti illustrer\u00f2 uno script T-SQL che crea snapshot coerenti con le applicazioni su Pure Storage\u00ae <\/sup>FlashArray<\/a>\u2122<\/sup>, il tutto all’interno di SQL Server, senza strumenti esterni. SQL Server 2025 introduce una nuova potente funzionalit\u00e0: la procedura sp_invoke_external_rest_endpoint<\/em> memorizzata. Questo miglioramento rende pi\u00f9 facile che mai chiamare le API REST direttamente da T-SQL. Combinando questa nuova funzionalit\u00e0 con l’API Pure Storage, possiamo orchestrare le operazioni delle snapshot in modo trasparente, senza la necessit\u00e0 di strumenti o script esterni.<\/p>\n\n\n\n

Se hai seguito la mia serie “Uso del backup delle snapshot T-SQL”,<\/a> sai che questa funzionalit\u00e0 offre enormi vantaggi per gli ambienti di database di grandi dimensioni. Oggi vedremo come implementarlo direttamente in T-SQL sfruttando la capacit\u00e0 di SQL Server di chiamare endpoint REST esterni, senza richiedere PowerShell.<\/p>\n\n\n\n

In T-SQL, sfruttando la capacit\u00e0 di SQL Server di chiamare endpoint REST esterni, non \u00e8 necessario PowerShell.<\/p>\n\n\n\n

Puoi trovare l’intero scriptqui<\/a>.<\/strong><\/p>\n\n\n\n

\n\n\n\n

Abilitazione dell’endpoint REST in SQL Server 2025<\/h2>\n\n\n\n

Per prima cosa, ci assicuriamo di poterci connettere agli endpoint REST esterni:<\/p>\n\n\n\n

sp_configure 'external rest endpoint enabled', 1;\nRECONFIGURE WITH OVERRIDE;\n<\/code><\/pre>\n\n\n\n
Ci\u00f2 abilita la funzionalit\u00e0 dell’endpoint REST di SQL Server, che consente al nostro SQL Server di effettuare chiamate REST API in uscita. Questo \u00e8 fondamentale per connettersi all’API di FlashArray e attivare le snapshot.<\/p>\n\n\n\n
\u00c8 importante notare cherichiede che tutti gli endpoint sp_invoke_external_rest_endpoint<\/code>utilizzino HTTPS con crittografia TLS e che il certificato deve essere attendibile dal sistema operativo sottostante che ospita l’istanza SQL Server.<\/p>\n\n\n\n
Autenticazione con FlashArray<\/h2>\n\n\n\n
Successivamente, stabiliremo una sessione sicura con Pure Storage FlashArray utilizzando la procedura di sp_invoke_external_rest_endpoint<\/code>newstored di SQL Server 2025. Questa funzionalit\u00e0 rappresenta un progresso significativo nelle funzionalit\u00e0 di SQL Server, consentendoci di effettuare chiamate API REST direttamente da T-SQL senza script esterni.<\/p>\n\n\n\n
Per l’autenticazione a un FlashArray, inviamo prima un token API <\/a>con autorizzazioni sufficienti all’endpoint di accesso di FlashArray. Una volta completata correttamente l’autenticazione, FlashArray restituisce anx-auth-token<\/code>nelle intestazioni di risposta, che diventano le nostre credenziali di sessione per tutte le operazioni API successive in questa sessione. Questo modello di autenticazione basato su token fornisce un meccanismo sicuro e limitato nel tempo per le interazioni API, mantenendo al tempo stesso un chiaro audit trail delle operazioni.<\/p>\n\n\n\n
Nel codice che segue, eseguiremo questa richiesta di autenticazione ed estrarremo il tokenx-authdalla<\/code> risposta JSON per creare le nostre intestazioni di autorizzazione per le chiamate API REST successive.<\/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
Gestione degli errori ed estrazione dei token<\/h2>\n\n\n\n
Successivamente, verificheremo il successo dell’accesso ed estrarremo il token di autenticazione. Se il codice di reso di FlashArray \u00e8 diverso da 0, verr\u00e0 visualizzato un messaggio di errore e verr\u00e0 visualizzato il messaggio di uscita. Ipotizzando il successo, leggeremo il tokenx-authdalla<\/code> risposta di accesso. Tenere presente che la chiave token deve includere virgolette doppie \"x-auth-token\"<\/code> per JSON_VALUE<\/code>assicurarsidi analizzarla correttamente. Una volta estratto, utilizzeremo il token per costruire l’intestazione di autorizzazione per le successive chiamate API REST all’array.<\/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
Congelamento del database per le snapshot<\/h2>\n\n\n\n
Il passaggio cruciale \u00e8 la sospensione dell’I\/O di scrittura del database per prepararsi all’istantanea. Questo comando utilizza la funzionalit\u00e0 di backup snapshot T-SQL di SQL Server 2022 per bloccare le operazioni di I\/O di scrittura sul database. Il database rimane leggibile, ma le operazioni di scrittura vengono sospese fino al completamento del processo di snapshot. In questo modo otteniamo una snapshot coerente con le applicazioni.<\/p>\n\n\n\n
ALTER DATABASE [TestDB1] SET SUSPEND_FOR_SNAPSHOT_BACKUP = ON\n<\/code><\/pre>\n\n\n\n
Scattare le snapshot dello storage<\/h2>\n\n\n\n
Con l’I\/O di scrittura bloccato nel database, siamo pronti per scattare una snapshot su FlashArray. Il passo successivo \u00e8 chiamare l’endpointprotection-group-snapshots<\/code>REST RESTper avviare un backup delle snapshot del gruppo di protezione.<\/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
Qui chiamiamo REST REST APIprotection-group-snapshotsendpoint<\/code> di FlashArray per creare una snapshot di un gruppo di protezione denominatoaen-sql-25-a-pg<\/code>. Il gruppo di protezione deve contenere tutti i volumi in cui sono archiviati i file di database. FlashArray creer\u00e0 una snapshot point-in-time di tutti i volumi in questo gruppo di protezione.<\/p>\n\n\n\n
Estrazione del nome dell’istantanea e creazione del backup<\/h2>\n\n\n\n
Nel prossimo passaggio, estrarremo il nome dello snapshot dalla risposta JSON di FlashArray utilizzandoJSON_VALUE(@response, \"$.result.items[0].name\").<\/code> Questo nome sar\u00e0 incluso nella descrizione dei supporti di backup come parte di un backup di soli metadati. Se FlashArray restituisce un codice di successo (codice di ritorno = 0), procederemo con il backup utilizzando il comandoBACKUP DATABASE<\/code> e l’METADATA_ONLY<\/code>opzione. Questo crea un file di backup leggero che contiene solo i metadati del database e un riferimento allo snapshot FlashArray inMEDIADESCRIPTION<\/code>. La memorizzazione del nome dello snapshot in MEDIADESCRIPTION facilita l’identificazione e il posizionamento dello snapshot FlashArray corrispondente quando si esegue un’operazione di restore.<\/p>\n\n\n\n
Se l’operazione di snapshot non riesce, registriamo un messaggio di errore e annulliamo immediatamente la sospensione del database per riprendere il normale I\/O di scrittura.<\/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
Controllo del registro degli errori di SQL Server<\/h2>\n\n\n\n
Per verificare il funzionamento del backup, controlliamo il registro degli errori di SQL Server.<\/p>\n\n\n\n
Il registro degli errori di SQL Server conferma un backup snapshot di soli metadati del database TestDB1. Il registro mostra che il database \u00e8 stato sospeso, l’I\/O di scrittura \u00e8 stato bloccato e la snapshot \u00e8 stata scattata prima che l’I\/O fosse ripristinato in modo sicuro. Poich\u00e9 si tratta di un backup di soli metadati, non sono state elaborate pagine di dati; solo i metadati sono stati acquisiti e scritti nel file bkm<\/code> specificato. Ci\u00f2 garantisce una snapshot coerente con le applicazioni con un impatto minimo sulla disponibilit\u00e0 dei database.<\/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
Ecco l’output delle dichiarazioni di stampa che abbiamo utilizzato in precedenza. Il backup delle snapshot \u00e8 stato completato correttamente: il sistema \u00e8 stato autenticato con FlashArray, ha sospeso TestDB1 per bloccare l’I\/O, ha creato la snapshot (aen-sql-25-a-pg.17),<\/code> ha ripreso l’I\/O e ha terminato con un backup di soli metadati, il tutto confermato tramite i log di SQL Server e le risposte 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
Riepilogo delle cose<\/h2>\n\n\n\n
Questo esempio illustra come la nuova sp_invoke_external_rest_endpoint<\/code>procedura di SQL Server 2025 trasforma l’automazione del backup. In precedenza, l’integrazione con i sistemi di storage richiedeva PowerShell o strumenti esterni. Ora possiamo effettuare chiamate API REST in modo nativo da T-SQL, semplificando i workflow e riducendo la complessit\u00e0.<\/p>\n\n\n\n
Vantaggi principali:<\/p>\n\n\n\n