Importare documenti JSON in SQL Server

Si applica a: SQL Server 2016 (13.x) e alle sue versioni successive Database SQL di Azure Istanza gestita di SQL di Azure

Questo articolo descrive come importare file JSON in SQL Server. I documenti JSON archiviano molti tipi di dati, ad esempio i log applicazioni, i dati dei sensori e così via. È importante essere in grado di leggere i dati JSON archiviati in file, caricare i dati in SQL Server e quindi analizzarli.

Gli esempi in questo articolo usano un file JSON da un esempio GitHub contenente un elenco di libri.

Autorizzazioni

A livello di istanza, questa funzionalità richiede l'appartenenza al ruolo predefinito del server bulkadmin o le autorizzazioni ADMINISTER BULK OPERATIONS.

Per il livello di database, questa funzionalità richiede le autorizzazioni ADMINISTER DATABASE BULK OPERATIONS.

L'accesso alle archiviazioni BLOB di Azure richiede l'accesso in lettura/scrittura.

Importare un documento JSON in una singola colonna

OPENROWSET(BULK) è una funzione con valori di tabella che consente di leggere i dati da qualsiasi file nell'unità locale o in rete, se SQL Server ha accesso in lettura a tale percorso. Restituisce una tabella con una sola colonna con il contenuto del file. Sono disponibili diverse opzioni che è possibile usare con la funzione OPENROWSET(BULK), ad esempio i separatori. Nel caso più semplice, tuttavia, è possibile limitarsi a caricare l'intero contenuto di un file come un valore di testo, Questo singolo valore di grandi dimensioni è noto come singolo oggetto CLOB (Character Large Object) o SINGLE_CLOB.

Di seguito è riportato un esempio della funzione OPENROWSET(BULK) che legge il contenuto di un file JSON e lo restituisce all'utente come singolo valore:

SELECT BulkColumn
FROM OPENROWSET(BULK 'C:\JSON\Books\book.json', SINGLE_CLOB) as j;

OPENJSON(BULK) legge il contenuto del file e lo restituisce in BulkColumn.

È anche possibile caricare il contenuto del file in una variabile locale o in una tabella, come illustrato nell'esempio seguente:

-- Load file contents into a variable
DECLARE @json NVARCHAR(MAX);
SELECT @json = BulkColumn
 FROM OPENROWSET(BULK 'C:\JSON\Books\book.json', SINGLE_CLOB) as j

-- Load file contents into a table
SELECT BulkColumn
INTO #temp
FROM OPENROWSET(BULK 'C:\JSON\Books\book.json', SINGLE_CLOB) as j

Dopo aver caricato il contenuto del file JSON è possibile salvare il testo JSON in una tabella.

Importare documenti JSON dall'archiviazione file di Azure

È anche possibile usare OPENROWSET(BULK) come descritto in precedenza per leggere i file JSON da altri percorsi di file a cui SQL Server è in grado di accedere. L'archiviazione file di Azure, ad esempio, supporta il protocollo SMB. Di conseguenza è possibile mappare un'unità virtuale locale alla condivisione di archiviazione file di Azure tramite la procedura seguente:

1. Creare un account di archiviazione di file (ad esempio, mystorage), una condivisione file (ad esempio, sharejson) e una cartella nell'archiviazione file di Azure tramite il portale di Azure o Azure PowerShell.

2. Caricare alcuni file JSON nella condivisione di archiviazione di file.

3. Creare una regola del firewall in uscita in Windows Firewall nel computer per consentire la porta 445. Il provider di servizi Internet potrebbe bloccare questa porta. Se si verifica un errore DNS (errore 53) nel passaggio seguente, significa che la porta 445 non è aperta o è bloccata dall'ISP.

4. Montare la condivisione dell'archiviazione file di Azure come unità locale (ad esempio T:).

   Questa è la sintassi del comando:

   net use [drive letter] \\[storage name].file.core.windows.net\[share name] /u:[storage account name] [storage account access key]
   

   Di seguito è riportato un esempio che assegna la lettera di unità locale T: alla condivisione dell'archiviazione file di Azure:

   net use t: \\mystorage.file.core.windows.net\sharejson /u:myaccount hb5qy6eXLqIdBj0LvGMHdrTiygkjhHDvWjUZg3Gu7bubKLg==
   

   La chiave dell'account di archiviazione e la chiave di accesso all'account di archiviazione primario o secondario sono disponibili nella sezione Chiavi in Impostazioni nel portale di Azure.

5. È ora possibile accedere ai file JSON dalla condivisione dell'archiviazione file di Azure usando l'unità mappata, come illustrato nell'esempio seguente:

   SELECT book.*
   FROM OPENROWSET(BULK N't:\books\books.json', SINGLE_CLOB) AS json
   CROSS APPLY OPENJSON(BulkColumn) WITH (
       id NVARCHAR(100),
       name NVARCHAR(100),
       price FLOAT,
       pages_i INT,
       author NVARCHAR(100)
   ) AS book
   

Per altre informazioni sull'archiviazione file di Azure, vedere Archiviazione file.

Importare documenti JSON da Archiviazione BLOB di Azure

Si applica a: SQL Server 2017 (14.x) e versioni successive e Azure SQL.

È possibile caricare i file direttamente nel database SQL di Azure da Archiviazione BLOB di Azure con il comando T-SQL BULK INSERT o la funzione OPENROWSET.

Per prima cosa creare un'origine dati esterna, come illustrato nell'esempio seguente.

CREATE EXTERNAL DATA SOURCE MyAzureBlobStorage
WITH (
    TYPE = BLOB_STORAGE,
    LOCATION = 'https://myazureblobstorage.blob.core.windows.net',
    CREDENTIAL = MyAzureBlobStorageCredential
);

Eseguire poi un comando BULK INSERT con l'opzione DATA_SOURCE.

BULK INSERT Product
FROM 'data/product.dat'
WITH ( DATA_SOURCE = 'MyAzureBlobStorage');

Analizzare i documenti JSON come righe e colonne

Anziché leggere un intero file JSON come singolo valore, può essere utile analizzarlo e restituire i libri nel file e le relative proprietà in righe e colonne.

Esempio 1

Nell'esempio più semplice, è possibile caricare semplicemente l'intero elenco dal file.

SELECT value
FROM OPENROWSET(BULK 'C:\JSON\Books\books.json', SINGLE_CLOB) AS j
CROSS APPLY OPENJSON(BulkColumn);

La funzione OPENROWSET precedente legge un singolo valore di testo dal file. OPENROWSET restituisce il valore come BulkColumn e passa BulkColumn alla funzione OPENJSON. OPENJSON esegue l'iterazione della matrice di oggetti JSON nella matrice BulkColumn e restituisce un libro in ogni riga. Ogni riga è formattata come JSON, come mostrato di seguito.

{"id":"978-0641723445", "cat":["book","hardcover"], "name":"The Lightning Thief", ... }
{"id":"978-1423103349", "cat":["book","paperback"], "name":"The Sea of Monsters", ... }
{"id":"978-1857995879", "cat":["book","paperback"], "name":"Sophie's World : The Greek", ... }
{"id":"978-1933988177", "cat":["book","paperback"], "name":"Lucene in Action, Second", ... }

Esempio 2

La funzione OPENJSON può analizzare il contenuto JSON e trasformarlo in una tabella o un set di risultati. L'esempio seguente carica il contenuto, analizza i dati JSON caricati e restituisce i cinque campi come colonne:

SELECT book.*
FROM OPENROWSET(BULK 'C:\JSON\Books\books.json', SINGLE_CLOB) AS j
CROSS APPLY OPENJSON(BulkColumn) WITH (
    id NVARCHAR(100),
    name NVARCHAR(100),
    price FLOAT,
    pages_i INT,
    author NVARCHAR(100)
) AS book;

In questo esempio, OPENROWSET(BULK) legge il contenuto del file e passa il contenuto alla funzione OPENJSON con uno schema definito per l'output. OPENJSON stabilisce le corrispondenze per le proprietà negli oggetti JSON usando i nomi di colonna. Ad esempio, la proprietà price viene restituita come una colonna price e convertita nel tipo di dati float. Ecco i risultati:

A questo punto è possibile restituire questa tabella all'utente o caricare i dati in un'altra tabella.

Contenuto correlato

• JSON as a bridge between NoSQL and relational worlds (JSON come ponte tra NoSQL e gli ambienti relazionali)
• Analizzare e trasformare dati JSON con OPENJSON