Condividi tramite


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

Questo articolo illustra come usare l'attività di copia nella pipeline di dati per copiare dati da e in tabelle di Azure Archiviazione.

Configurazione supportata

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

Generali

Fare riferimento alle indicazioni generali sulle impostazioni 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.

Screenshot showing source tab and the list of properties.

Sono necessarie le tre proprietà seguenti:

  • Tipo di archivio dati: selezionare Esterno.

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

  • Usare la query: specificare il modo per leggere i dati. Selezionare Tabella per leggere i dati dalla tabella specificata oppure selezionare Query per leggere i dati usando query.

    Se si seleziona Tabella:

    Screenshot showing Use query when selecting Table.

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

    Se si seleziona Query:

    Screenshot showing Use query when selecting Query.

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

    • Query: specificare la query di archiviazione tabelle personalizzata per leggere i dati. La query di origine è una mappa diretta dall'opzione $filter di query supportata da Tabella di Azure Archiviazione. Altre informazioni sulla sintassi di 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 Avanzate è possibile specificare i campi seguenti:

  • Ignora tabella non trovata: specifica se consentire l'esistenza dell'eccezione della tabella. È deselezionata per impostazione predefinita.

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

Destinazione

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

Screenshot showing destination tab and the list of properties.

Sono necessarie le tre proprietà seguenti:

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

In Avanzate è possibile specificare i campi seguenti:

  • Tipo di inserimento: selezionare la modalità per inserire i dati nella tabella di Azure. Le modalità sono Merge e Replace. 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 opzioni elimina le 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 da Specificare il valore della partizione o Usare 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 Specificare 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 usati come chiave di riga. Se non specificato, usare un GUID per ogni riga.
  • Dimensioni 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 Impostazioni configurazione della scheda, passare a Configurare le altre impostazioni nella scheda Impostazioni.

Riepilogo tabella

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

Informazioni sull'origine

Nome Descrizione Valore Richiesto Proprietà script JSON
Tipo di archivio dati Tipo di archivio dati. Esterno /
Connessione Connessione all'archivio dati di origine. <connessione Archiviazione tabella di Azure> connection
Usare la query Modalità di lettura dei dati. Applicare la tabella per leggere i dati dalla tabella specificata o applicare Query per leggere i dati usando query. •Tavolo
•Query
/
Tabella Nome della tabella nell'istanza del database table di Azure Archiviazione. < nome della tabella > tableName
Query Specificare la query di archiviazione tabelle personalizzata per leggere i dati. La query di origine è una mappa diretta dall'opzione $filter di query supportata da Tabella di Azure Archiviazione. Altre informazioni sulla sintassi di 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 (impostazione predefinita)
Colonne aggiuntive Aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. L'espressione è supportata per quest'ultima. • Name
•Valore
No additionalColumns:
•Nome
•Valore

Informazioni sulla destinazione

Nome Descrizione Valore Richiesto Proprietà script JSON
Tipo di archivio dati Tipo di archivio dati. Esterno /
Connessione Connessione all'archivio dati di destinazione. <connessione Archiviazione tabella di Azure> connection
Tabella Nome della tabella nell'istanza del database table di Azure Archiviazione. < nome della tabella > tableName
Inserisci tipo 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. Unione
Sostituisci
No azureTableInsertType:
•Unione
•Sostituire
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. Specificare il valore della partizione
Usare 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 Nome della colonna i cui valori vengono utilizzati come chiavi di partizione. Se non specificato, viene usato "AzureTableDefaultPartitionKeyValue" come chiave di partizione. < colonna della 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
Usare la colonna di destinazione
No /
Colonna chiave di riga Nome della colonna i cui valori di colonna vengono utilizzati come chiave di riga. Se non specificato, usare un GUID per ogni riga. < colonna chiave di riga > No azureTableRowKeyName
Dimensioni batch di scrittura Inserisce i dati nella tabella di Azure quando viene raggiunta la dimensione del batch di scrittura. Intero
(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. < connessioni simultanee massime > No maxConcurrentConnections