Configurare Archiviazione tabelle di Azure in un'attività di copia

Questo articolo descrive come utilizzare l'attività di copia nella pipeline di dati per copiare dati da e verso Archiviazione tabelle di Azure.

Configurazione supportata

Per la configurazione di ogni scheda nell'attività di copia, consultare rispettivamente le sezioni seguenti.

• Generali
• Origine
• Destinazione
• Mapping
• Impostazioni

Generali

Consultare la guida sulle Impostazioni generali per configurare la scheda Impostazioni generali.

Origine

Passare alla scheda Origine per configurare l'origine dell'attività di copia. Per la configurazione dettagliata, vedere il contenuto seguente.

Le seguenti tre proprietà sono obbligatorie:

• Tipo di archivio dati: selezionare Esterno.

• Connessione: selezionare una connessione di Archiviazione tabelle di Azure dall'elenco delle connessioni. Se non esiste alcuna connessione, creare una nuova connessione di Archiviazione tabelle di Azure selezionando Nuovo.

• Usa query: specifica il modo in cui leggere i dati. Selezionare Tabella per leggere i dati dalla tabella specificata oppure selezionare Query per leggere i dati usando le query.

  Se si seleziona Tabella:

  

  • Tabella: specificare il nome della tabella nell'istanza di database di Archiviazione tabelle di Azure. Selezionare la tabella dall'elenco a discesa o immettere manualmente il nome selezionando Modifica.

  Se si seleziona Query:

  

  • Tabella: specificare il nome della tabella nell'istanza di database di Archiviazione tabelle di Azure. Selezionare la tabella dall'elenco a discesa o immettere manualmente il nome selezionando Modifica.

  • Query: specificare la query di archiviazione tabella personalizzata per leggere i dati. La query di origine è una mappa diretta dall'opzione di query $filter supportata da Archiviazione tabelle di Azure; per ulteriori informazioni sulla sintassi, consulta questo articolo.

    Nota

    Il timeout dell'operazione di query di Tabella di Azure è di 30 secondi, secondo quanto applicato dal servizio tabelle di Azure. Per informazioni su come ottimizzare la query, vedere l'articolo Progettazione per le query.

In Avanzato è possibile specificare i seguenti campi:

• Ignora tabella non trovata: specificare se consentire l'eccezione della tabella inesistente. È non selezionata per impostazione predefinita.

• Colonne aggiuntive: aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. Per quest'ultimo è supportata l'espressione.

Destinazione

Passare alla scheda Destinazione per configurare la destinazione dell'attività di copia. Per la configurazione dettagliata, vedere il contenuto seguente.

Le seguenti tre proprietà sono obbligatorie:

• Tipo di archivio dati: selezionare Esterno.
• Connessione: selezionare una connessione di Archiviazione tabelle di Azure dall'elenco delle connessioni. Se non esiste alcuna connessione, creare una nuova connessione di Archiviazione tabelle di Azure selezionando Nuovo.
• Tabella: specificare il nome della tabella nell'istanza di database di Archiviazione tabelle di Azure. Selezionare la tabella dall'elenco a discesa o immettere manualmente il nome selezionando Modifica.

In Avanzato è possibile specificare i seguenti campi:

• Tipo di inserimento: seleziona la modalità per inserire i dati nella tabella di Azure. Le modalità sono Unisci e Sostituisci. Questa proprietà verifica se per le righe esistenti nella tabella di output con chiavi di partizione e di riga corrispondenti i valori vengono sostituiti o uniti. Questa impostazione si applica a livello di riga e non a livello di tabella. Nessuna delle due opzioni consente di eliminare righe nella tabella di output che non esistono nell'input. Per scoprire come funzionano le impostazioni merge e replace, vedereInsert or Merge Entity (Inserire o unire un'entità) e Insert or Replace Entity (Inserire o sostituire un'entità).

• Selezione del valore della chiave di partizione: selezionare tra Specifica il valore della partizione o Usa la colonna di destinazione. Il valore della chiave di partizione può essere un valore fisso oppure può accettare un valore da una colonna di destinazione.

  Se si seleziona Specifica il valore della partizione:

  • Valore predefinito della partizione: specificare il valore predefinito della chiave di partizione che può essere usato dalla destinazione.

  Se si seleziona Usa colonna di destinazione:

  • Colonna chiave di partizione: selezionare il nome della colonna i cui valori di colonna vengono usati come chiave di partizione. Se non specificato, viene usato "AzureTableDefaultPartitionKeyValue" come chiave di partizione.

• Selezione del valore della chiave di riga: selezionare da Identificatore univoco o Usa colonna di destinazione. Il valore della chiave di riga può essere un identificatore univoco generato automaticamente oppure può accettare valore da una colonna di destinazione.

  Se si seleziona Usa colonna di destinazione:

  • Colonna chiave di riga: selezionare il nome della colonna i cui valori di colonna vengono utilizzati come chiave di riga. Se non specificato, usare un GUID per ogni riga.

• Dimensione batch di scrittura: inserisce i dati nella tabella di Azure quando viene raggiunta la dimensione del batch di scrittura specificata. I valori consentiti sono integer (numero di righe). Il valore predefinito è 10.000.

• Timeout del batch di scrittura: inserisce i dati nella tabella di Azure quando viene raggiunto il timeout del batch di scrittura specificato. Il valore consentito è timespan.

• Numero massimo di connessioni simultanee: limite massimo di connessioni simultanee stabilite all'archivio dati durante l'esecuzione dell'attività. Specificare un valore solo quando si desidera limitare le connessioni simultanee

Mapping

Per la configurazione della scheda Mapping, vedere Configurare i mapping nella scheda Mapping.

Impostazione

Per la configurazione della scheda Impostazioni, vedere Configurare le altre impostazioni nella scheda Impostazioni.

Riepilogo della tabella

La tabella seguente contiene altre informazioni sull'attività di copia in Archiviazione tabelle di Azure.

Informazioni sull'origine

Nome	Descrizione	valore	Richiesto	Proprietà dello script JSON
Tipo di archivio dati	Tipo di archivio dati.	Esterno	Sì	/
Connessione	Connessione all'archivio dati di origine.	< connessione di Archiviazione tabelle di Azure >	Sì	connection
Usa query	Modalità di lettura dei dati. Applicare Tabella per leggere i dati dalla tabella specificata o applicare Query per leggere i dati usando le query.	• Tabella • Query	Sì	/
Tabella	Nome della tabella nell'istanza di database di Archiviazione tabelle di Azure.	< nome alla tabella >	Sì	tableName
Query	Specificare la query di Archiviazione della tabella personalizzata per leggere i dati. La query di origine è una mappa diretta dall'opzione di query $filter supportata da Archiviazione tabelle di Azure; per ulteriori informazioni sulla sintassi, consulta questo articolo.	< query >	No	AzureTableSourceQuery
Ignora tabella non trovata	Indica se consentire l'eccezione di tabella non esistente.	selezionato o non selezionato (impostazione predefinita)	No	azureTableSourceIgnoreTableNotFound: true o false (valore predefinito)
Colonne aggiuntive	Aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. Per quest'ultimo è supportata l'espressione.	• Name • Valore	No	additionalColumns: • nome • valore

Informazioni sulla destinazione

Nome	Descrizione	valore	Richiesto	Proprietà dello script JSON
Tipo di archivio dati	Tipo di archivio dati.	Esterno	Sì	/
Connessione	Connessione all'archivio dati di destinazione.	< connessione di Archiviazione tabelle di Azure >	Sì	connection
Tabella	Nome della tabella nell'istanza di database di Archiviazione tabelle di Azure.	< nome alla tabella >	Sì	tableName
Tipo di inserimento	Modalità di inserimento dei dati in una tabella di Azure. Questa proprietà verifica se per le righe esistenti nella tabella di output con chiavi di partizione e di riga corrispondenti i valori vengono sostituiti o uniti.	• Unisci • Sostituisci	No	azureTableInsertType: • unisci • sostituisci
Selezione del valore della chiave di partizione	Il valore della chiave di partizione può essere un valore fisso oppure può accettare un valore da una colonna di destinazione.	• Specifica il valore della partizione • Usa la colonna di destinazione	No	/
Valore predefinito della partizione	Valore predefinito della chiave di partizione che può essere usato dalla destinazione	< valore predefinito della partizione >	No	azureTableDefaultPartitionKeyValue
Colonna chiave di partizione	Il nome della colonna i cui valori vengono usati come chiavi di partizione. Se non specificato, viene usato "AzureTableDefaultPartitionKeyValue" come chiave di partizione.	< colonna chiave di partizione >	No	azureTablePartitionKeyName
Selezione del valore della chiave di riga	Il valore della chiave di riga può essere un identificatore univoco generato automaticamente oppure può accettare valore da una colonna di destinazione.	• Identificatore univoco • Usa la colonna di destinazione	No	/
Colonna chiave di riga	Il nome della colonna i cui valori vengono usati come chiave di riga. Se non specificato, usare un GUID per ogni riga.	< colonna chiave di riga >	No	azureTableRowKeyName
Dimensione del batch di scrittura	Inserisce i dati nella tabella di Azure quando viene raggiunta la dimensione del batch di scrittura.	integer (il valore predefinito è 10.000)	No	writeBatchSize
Timeout del batch di scrittura	Inserisce i dati nella tabella di Azure quando viene raggiunto il timeout del batch di scrittura	timespan	No	writeBatchTimeout
Numero massimo di connessioni simultanee	Limite massimo di connessioni simultanee stabilite all'archivio dati durante l'esecuzione dell'attività. Specificare un valore solo quando si desidera limitare le connessioni simultanee.	< numero massimo di connessioni simultanee >	No	maxConcurrentConnections

Contenuto correlato

• Panoramica del connettore di Archiviazione tabelle di Azure