Attività Azure Synapse Analytics

Si applica a: SQL Server SSIS Integration Runtime in Azure Data Factory

L'attività Azure Synapse Analytics consente a un pacchetto SSIS di copiare i dati tabulari in un pool SQL dedicato di Azure Synapse Analytics dal file system o da Archiviazione BLOB di Azure. L'attività usa PolyBase per migliorare le prestazioni, come descritto nell'articolo Modelli e strategie di caricamento di Azure Synapse Analytics. Il formato di file dei dati di origine attualmente supportato è testo delimitato in codifica UTF8. Quando si copia dal file system, i dati vengono prima caricati in Archiviazione BLOB di Azure per lo staging e poi nel pool SQL dedicato. Per questo motivo, è quindi necessario un account di Archiviazione BLOB di Azure.

Nota

La gestione connessione di Archiviazione di Azure con tipo di servizio Data Lake Gen2 non è supportata.

Per usare Azure Data Lake Gen2 per la gestione temporanea o l'origine, è possibile connettersi tramite la gestione connessione di Archiviazione di Azure con il tipo di Archiviazione BLOB di Azure.

L'attività Azure Synapse Analytics è un componente del Feature Pack di SQL Server Integration Services (SSIS) per Azure.

Per aggiungere un'attività Azure Synapse Analytics, trascinare l'attività da Casella degli strumenti SSIS nei canvas di progettazione, fare doppio clic o fare clic con il pulsante destro del mouse e selezionare Modifica per visualizzare la finestra di dialogo dell'editor dell'attività.

Nella pagina Generale configurare le proprietà seguenti.

SourceType specifica il tipo di archivio dati di origine. Selezionare uno dei tipi seguenti:

  • FileSystem: i dati di origine si trovano nel file system locale.
  • BlobStorage: i dati di origine si trovano in Archiviazione BLOB di Azure.

Di seguito sono elencate le proprietà per ogni tipo di origine.

FileSystem

Campo Descrizione
LocalDirectory Specifica la directory locale che contiene i file di dati da caricare.
Recursively (Ricorsivo) Specifica se eseguire una ricerca ricorsiva delle sottodirectory.
FileName Specifica un filtro per nome per selezionare i file con un determinato modello di nome. Ad esempio, Foglio*.xsl* includerà file come Foglio001.xls e FoglioABC.xlsx.
RowDelimiter Specifica il carattere che contrassegna la fine di ogni riga.
ColumnDelimiter Specifica uno o più caratteri che contrassegnano la fine di ogni colonna. Ad esempio, | (barra verticale), \t (TAB), ' (virgoletta singola), " (virgoletta doppia) e 0x5c (barra rovesciata).
IsFirstRowHeader Specifica se la prima riga in ogni file di dati contiene nomi di colonna anziché dati effettivi.
AzureStorageConnection Specifica una gestione connessione di Archiviazione di Azure.
BlobContainer Specifica il nome di un contenitore BLOB in cui i dati locali verranno caricati e inoltrati al pool SQL dedicato di Azure Synapse Analytics tramite PolyBase. Se il contenitore non esiste, ne verrà creato uno nuovo.
BlobDirectory Specifica la directory BLOB (struttura gerarchica virtuale) in cui i dati locali verranno caricati e inoltrati al pool SQL dedicato di Azure Synapse Analytics tramite PolyBase.
RetainFiles Specifica se mantenere i file caricati in Archiviazione di Azure.
CompressionType Specifica il formato di compressione da usare durante il caricamento dei file in Archiviazione di Azure. L'origine locale non è interessata.
CompressionLevel Specifica il livello di compressione da usare per il formato di compressione.
SqlPoolConnection Specifica una gestione connessione ADO.NET per il pool SQL dedicato di Azure Synapse Analytics.
TableName Specifica il nome della tabella di destinazione. Scegliere un nome di tabella esistente o crearne uno nuovo scegliendo <Nuova tabella>.
TableDistribution Specifica il metodo di distribuzione per la nuova tabella. Si applica se per TableNameviene specificato un nuovo nome tabella.
HashColumnName Specifica la colonna usata per la distribuzione di tabelle hash. Si applica se HASH è specificato per TableDistribution.

BlobStorage

Campo Descrizione
AzureStorageConnection Specifica una gestione connessione di Archiviazione di Azure.
BlobContainer Specifica il nome del contenitore BLOB in cui risiedono i dati di origine.
BlobDirectory Specifica la directory BLOB (struttura gerarchica virtuale) in cui risiedono i dati di origine.
RowDelimiter Specifica il carattere che contrassegna la fine di ogni riga.
ColumnDelimiter Specifica uno o più caratteri che contrassegnano la fine di ogni colonna. Ad esempio, | (barra verticale), \t (TAB), ' (virgoletta singola), " (virgoletta doppia) e 0x5c (barra rovesciata).
CompressionType Specifica il formato di compressione usato per i dati di origine.
SqlPoolConnection Specifica una gestione connessione ADO.NET per il pool SQL dedicato di Azure Synapse Analytics.
TableName Specifica il nome della tabella di destinazione. Scegliere un nome di tabella esistente o crearne uno nuovo scegliendo <Nuova tabella>.
TableDistribution Specifica il metodo di distribuzione per la nuova tabella. Si applica se per TableNameviene specificato un nuovo nome tabella.
HashColumnName Specifica la colonna usata per la distribuzione di tabelle hash. Si applica se HASH è specificato per TableDistribution.

Verrà visualizzata una pagina Mapping diversa a seconda che i dati siano copiati in una tabella nuova o in una esistente. Nel primo caso, configurare le colonne di origine da mappare e i relativi nomi nella tabella di destinazione da creare. Nel secondo caso, configurare le relazioni di mapping tra colonne di origine e di destinazione.

Nella pagina Colonne configurare le proprietà del tipo di dati per ogni colonna di origine.

La pagina T-SQL visualizza il linguaggio T-SQL usato per caricare i dati da Archiviazione BLOB di Azure in un pool SQL dedicato. T-SQL viene generato automaticamente dalle configurazioni in altre pagine e verrà eseguito come parte dell'esecuzione dell'attività. È possibile scegliere di modificare manualmente il linguaggio T-SQL generato per soddisfare esigenze specifiche. Fare quindi clic sul pulsante Modifica . È possibile ripristinare quello generato automaticamente selezionando poi il pulsante Reimposta .