Configurare Azure Synapse Analytics in un'attività di copia

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

Configurazione supportata

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

• Generali
• Origine
• Destinazione
• Mapping
• Impostazioni

Generali

Fare riferimento alle indicazioni generali sulle impostazioni per configurare la scheda Impostazioni generali .

Origine

Le proprietà seguenti sono supportate per Azure Synapse Analytics nella scheda Origine di un'attività di copia.

Sono necessarie le proprietà seguenti:

• Tipo di archivio dati: selezionare Esterno.

• Connessione ion: selezionare una connessione di Azure Synapse Analytics dall'elenco delle connessioni. Se la connessione non esiste, creare una nuova connessione di Azure Synapse Analytics selezionando Nuovo.

• Connessione tipo: selezionare Azure Synapse Analytics.

• Usare la query: è possibile scegliere Tabella, Query o Stored procedure per leggere i dati di origine. L'elenco seguente descrive la configurazione di ogni impostazione:

  • Tabella: legge i dati dalla tabella specificata in Tabella se si seleziona questo pulsante. Selezionare la tabella dall'elenco a discesa o selezionare Modifica per immettere manualmente lo schema e il nome della tabella.

    

  • Query: specificare la query SQL personalizzata per leggere i dati. Un esempio è select * from MyTable. In alternativa, selezionare l'icona a forma di matita da modificare nell'editor di codice.

    

  • Stored procedure: usare la stored procedure che legge i dati dalla tabella di origine. L'ultima istruzione SQL deve essere un'istruzione SELECT nella stored procedure.

    

    • Nome stored procedure: selezionare la stored procedure o specificare manualmente il nome della stored procedure quando si seleziona Modifica.
    • Parametri della stored procedure: selezionare Importa parametri per importare il parametro nella stored procedure specificata oppure aggiungere parametri per la stored procedure selezionando + Nuovo. I valori consentiti sono coppie nome-valore. I nomi e le maiuscole e minuscole dei parametri devono corrispondere ai nomi e alle maiuscole e minuscole dei parametri della stored procedure.

In Avanzate è possibile specificare i campi seguenti:

• Timeout query (minuti): specificare il timeout per l'esecuzione del comando di query, il valore predefinito è 120 minuti. Se per questa proprietà è impostato un parametro, i valori consentiti sono timepan, ad esempio "02:00:00" (120 minuti).

• Livello di isolamento: specifica il comportamento di blocco delle transazioni per l'origine SQL. I valori consentiti sono: Nessuno, Read committed, Read uncommitted, Repeatable read, Serializable o Snapshot. Se non specificato, viene utilizzato il livello di isolamento Nessuno . Per altri dettagli, vedere IsolationLevel Enum .

  

• Opzione di partizione: specificare le opzioni di partizionamento dei dati usate per caricare i dati da Azure Synapse Analytics. I valori consentiti sono: Nessuno (impostazione predefinita), Partizioni fisiche della tabella e Intervallo dinamico. Quando un'opzione di partizione è abilitata (ovvero non Nessuna), il grado di parallelismo per caricare simultaneamente i dati da un'istanza di Azure Synapse Analytics è controllato dall'impostazione di copia parallela nell'attività di copia .

  • Nessuno: scegliere questa impostazione per non usare una partizione.

  • Partizioni fisiche della tabella: scegliere questa impostazione se si vuole usare una partizione fisica. La colonna di partizione e il meccanismo vengono determinati automaticamente in base alla definizione della tabella fisica.

  • Intervallo dinamico: scegliere questa impostazione se si vuole usare la partizione di intervallo dinamico. Quando si usa la query con la funzionalità parallela abilitata, è necessario il parametro di partizione dell'intervallo(?DfDynamicRangePartitionCondition). Query di esempio: SELECT * FROM <TableName> WHERE ?DfDynamicRangePartitionCondition.

    

    • Nome colonna partizione: specificare il nome della colonna di origine nel tipo integer o date/datetime (int, smallint, datedatetimedatetime2bigintsmalldatetimeo datetimeoffset) usato dal partizionamento di intervalli per la copia parallela. Se non specificato, l'indice o la chiave primaria della tabella vengono rilevati automaticamente e usati come colonna di partizione.
    • Limite superiore della partizione: specificare il valore massimo della colonna di partizione per la suddivisione dell'intervallo di partizioni. Questo valore viene usato per decidere lo stride della partizione, non per filtrare le righe nella tabella. Tutte le righe nella tabella o nel risultato della query vengono partizionate e copiate.
    • Limite inferiore della partizione: specificare il valore minimo della colonna di partizione per la suddivisione dell'intervallo di partizioni. Questo valore viene usato per decidere lo stride della partizione, non per filtrare le righe nella tabella. Tutte le righe nella tabella o nel risultato della query vengono partizionate e copiate.

• 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. Per altre informazioni, vedere Aggiungere altre colonne durante la copia.

Destinazione

Le proprietà seguenti sono supportate per Azure Synapse Analytics nella scheda Destinazione di un'attività di copia.

Sono necessarie le proprietà seguenti:

• Tipo di archivio dati: selezionare Esterno.
• Connessione ion: selezionare una connessione di Azure Synapse Analytics dall'elenco delle connessioni. Se la connessione non esiste, creare una nuova connessione di Azure Synapse Analytics selezionando Nuovo.
• Connessione tipo: selezionare Azure Synapse Analytics.
• Opzione Tabella: è possibile scegliere Usa tabella esistente, Crea automaticamente. L'elenco seguente descrive la configurazione di ogni impostazione:
  • Usa esistente: selezionare la tabella nel database dall'elenco a discesa. In alternativa, selezionare Modifica per immettere manualmente lo schema e il nome della tabella.
  • Creazione automatica tabella: crea automaticamente la tabella (se inesistente) nello schema di origine.

In Avanzate è possibile specificare i campi seguenti:

• Metodo Copy Scegliere il metodo da usare per copiare i dati. È possibile scegliere Copia comando, PolyBase, Inserimento bulk o Upsert. L'elenco seguente descrive la configurazione di ogni impostazione:

  • Comando Copia: usare l'istruzione COPY per caricare dati da Archiviazione di Azure in Azure Synapse Analytics o nel pool SQL.

    

    • Consenti comando di copia: è obbligatorio selezionare quando si sceglie Copia comando.
    • Valori predefiniti: specificare i valori predefiniti per ogni colonna di destinazione in Azure Synapse Analytics. I valori predefiniti nella proprietà sovrascrivono il vincolo DEFAULT impostato nel data warehouse e la colonna Identity non può avere un valore predefinito.
    • Opzioni aggiuntive: opzioni aggiuntive che verranno passate a un'istruzione COPY di Azure Synapse Analytics direttamente nella clausola "With" nell'istruzione COPY. Racchiudere il valore tra virgolette come previsto dai requisiti dell'istruzione COPY.

  • PolyBase: PolyBase è un meccanismo a velocità effettiva elevata. Usarlo per caricare grandi quantità di dati in Azure Synapse Analytics o nel pool SQL.

    

    • Consenti PolyBase: è obbligatorio selezionare quando si sceglie PolyBase.
    • Tipo di rifiuto: specificare se l'opzione rejectValue è un valore letterale o una percentuale. I valori consentiti sono Value (predefinito) e Percentage.
    • Rifiuta valore: specificare il numero o la percentuale di righe che possono essere rifiutate prima che la query abbia esito negativo. Per altre informazioni sulle opzioni di rifiuto di PolyBase, vedere la sezione Argomenti in CREATE EXTERNAL TABLE (Transact-SQL). I valori consentiti sono 0 (predefinito), 1, 2 e così via.
    • Rifiuta valore di esempio: determina il numero di righe da recuperare prima che PolyBase ricalcola la percentuale di righe rifiutate. I valori consentiti sono 1, 2 e così via. Se si sceglie Percentuale come tipo di rifiuto, questa proprietà è obbligatoria.
    • Usa il tipo predefinito: specificare come gestire i valori mancanti nei file di testo delimitati quando PolyBase recupera i dati dal file di testo. Per altre informazioni su questa proprietà, vedere la sezione Arguments (Argomenti) in CREATE EXTERNAL FILE FORMAT (Transact-SQL). I valori consentiti sono selezionati (impostazione predefinita) o non selezionati.

  • Inserimento bulk: usare l'inserimento bulk per inserire dati nella destinazione in blocco.

    

    • Blocco tabella inserimento bulk: usare questa opzione per migliorare le prestazioni di copia durante l'operazione di inserimento bulk nella tabella senza indici di più client. Per altre informazioni, vedere BULK IN edizione Standard RT (Transact-SQL).

  • Upsert: specificare il gruppo delle impostazioni per il comportamento di scrittura quando si desidera eseguire l'upsert dei dati nella destinazione.

    

    • Colonne chiave: scegliere la colonna usata per determinare se una riga dall'origine corrisponde a una riga dalla destinazione.

    • Blocco tabella inserimento bulk: usare questa opzione per migliorare le prestazioni di copia durante l'operazione di inserimento bulk nella tabella senza indici di più client. Per altre informazioni, vedere BULK IN edizione Standard RT (Transact-SQL).

• Script di pre-copia: specificare uno script per l'attività di copia da eseguire prima di scrivere dati in una tabella di destinazione in ogni esecuzione. È possibile usare questa proprietà per pulire i dati precaricati.

• Timeout del batch di scrittura: specificare il tempo di attesa per il completamento dell'operazione di inserimento batch prima del timeout. Il valore consentito è timespan. Il valore predefinito è "00:30:00" (30 minuti).

• Dimensioni batch di scrittura: specificare il numero di righe da inserire nella tabella SQL per batch. Il valore consentito è integer (numero di righe). Per impostazione predefinita, il servizio determina in modo dinamico le dimensioni del batch appropriate in base alle dimensioni della riga.

• Numero massimo di connessioni simultanee: specificare il 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.

• Disabilitare l'analisi delle metriche delle prestazioni: questa impostazione viene usata per raccogliere metriche, ad esempio DTU, DWU, UR e così via, per l'ottimizzazione e le raccomandazioni sulle prestazioni di copia. Se si è interessati a questo comportamento, selezionare questa casella di controllo. È deselezionata per impostazione predefinita.

Copia diretta con il comando COPY

Il comando COPY di Azure Synapse Analytics supporta direttamente Archiviazione BLOB di Azure e Azure Data Lake Archiviazione Gen2 come archivi dati di origine. Se i dati di origine soddisfano i criteri descritti in questa sezione, usare il comando COPY per copiare direttamente dall'archivio dati di origine ad Azure Synapse Analytics.

1. I dati e il formato di origine contengono i tipi e i metodi di autenticazione seguenti:

   Tipo di archivio dati di origine supportato	Formato supportato	Tipo di autenticazione di origine supportato
   Archiviazione BLOB di Azure	Testo delimitato Parquet	Autenticazione anonima Autenticazione basata sulla chiave dell'account Autenticazione con firma di accesso condiviso
   Azure Data Lake Storage Gen2	Testo delimitato Parquet	Autenticazione basata sulla chiave dell'account Autenticazione con firma di accesso condiviso

2. È possibile impostare le impostazioni di formato seguenti:
   

   1. Per Parquet: il tipo di compressione può essere Nessuno, snappy o gzip.
   2. Per DelimitedText:
      1. Delimitatore di riga: quando si copia testo delimitato in Azure Synapse Analytics tramite il comando COPY diretto, specificare il delimitatore di riga in modo esplicito (\r; \n; o \r\n). Solo quando il delimitatore di riga del file di origine è \r\n, funziona il valore predefinito (\r, \n o \r\n). In caso contrario, abilitare la gestione temporanea per lo scenario.
      2. Il valore Null viene lasciato come predefinito o impostato su stringa vuota ("").
      3. La codifica viene lasciata come predefinita o impostata su UTF-8 o UTF-16.
      4. Il numero di righe ignorate viene lasciato come predefinito o impostato su 0.
      5. Il tipo di compressione può essere Nessuno o gzip.

3. Se l'origine è una cartella, è necessario selezionare la casella di controllo Ricorsivamente .

4. Ora di inizio (UTC) e Ora di fine (UTC) in Filtra per ultima modifica, Prefisso, Abilita individuazione partizione e Colonne aggiuntive non specificate.

Per informazioni su come inserire dati in Azure Synapse Analytics usando il comando COPY, vedere questo articolo.

Se l'archivio dati e il formato di origine non sono originariamente supportati da un comando COPY, usare invece la copia di staging usando la funzionalità di comando COPY. Converte automaticamente i dati in un formato compatibile con i comandi COPY, quindi chiama un comando COPY per caricare i dati in Azure Synapse Analytics.

Mapping

Per la configurazione della scheda Mapping , se non si applica Azure Synapse Analytics con la creazione automatica della tabella come destinazione, passare a Mapping.

Se si applica Azure Synapse Analytics con la tabella di creazione automatica come destinazione, ad eccezione della configurazione in Mapping, è possibile modificare il tipo per le colonne di destinazione. Dopo aver selezionato Importa schemi, è possibile specificare il tipo di colonna nella destinazione.

Ad esempio, il tipo per la colonna ID nell'origine è int ed è possibile modificarlo in tipo float quando si esegue il mapping alla colonna di destinazione.

Impostazione

Per Impostazioni configurazione della scheda, passare a Configurare le altre impostazioni nella scheda Impostazioni.

Copia parallela da Azure Synapse Analytics

Il connettore Azure Synapse Analytics nell'attività di copia fornisce il partizionamento dei dati predefinito per copiare i dati in parallelo. È possibile trovare le opzioni di partizionamento dei dati nella scheda Origine dell'attività di copia.

Quando si abilita la copia partizionata, l'attività di copia esegue query parallele sull'origine di Azure Synapse Analytics per caricare i dati in base alle partizioni. Il grado parallelo è controllato dal grado di parallelismo di copia nella scheda delle impostazioni dell'attività di copia. Ad esempio, se si imposta Degree of copy parallelism su quattro, il servizio genera simultaneamente ed esegue quattro query in base all'opzione e alle impostazioni di partizione specificate e ogni query recupera una parte di dati da Azure Synapse Analytics.

È consigliabile abilitare la copia parallela con il partizionamento dei dati, soprattutto quando si caricano grandi quantità di dati da Azure Synapse Analytics. Di seguito sono riportate le configurazioni consigliate per i diversi scenari: Quando si copiano dati in un archivio dati basato su file, è consigliabile scrivere in una cartella come più file (specificare solo il nome della cartella), nel qual caso le prestazioni sono migliori rispetto alla scrittura in un singolo file.

Scenario	Impostazioni consigliate
Caricamento completo da tabelle di grandi dimensioni, con partizioni fisiche.	Opzione di partizione: partizioni fisiche della tabella. Durante l'esecuzione, il servizio rileva automaticamente le partizioni fisiche e copia i dati in base alle partizioni. Per verificare se la tabella contiene o meno una partizione fisica, è possibile fare riferimento a questa query.
Caricamento completo da una tabella di grandi dimensioni, senza partizioni fisiche, mentre con una colonna integer o datetime per il partizionamento dei dati.	Opzioni di partizione: partizione intervallo dinamico. Colonna di partizione (facoltativa): specificare la colonna usata per partizionare i dati. Se non specificato, viene utilizzata la colonna di indice o chiave primaria. Limite superiore della partizione e limite inferiore della partizione (facoltativo): specificare se si desidera determinare lo stride della partizione. Non si tratta di filtrare le righe nella tabella, tutte le righe della tabella verranno partizionate e copiate. Se non specificato, l'attività di copia rileva automaticamente i valori. Ad esempio, se la colonna di partizione "ID" ha valori compresi tra 1 e 100 e si imposta il limite inferiore su 20 e il limite superiore come 80, con copia parallela come 4, il servizio recupera i dati rispettivamente per 4 partizioni - ID nell'intervallo <=20, [21, 50], [51, 80]e >=81.
Caricare una grande quantità di dati usando una query personalizzata, senza partizioni fisiche, mentre con una colonna integer o date/datetime per il partizionamento dei dati.	Opzioni di partizione: partizione intervallo dinamico. Query: SELECT * FROM <TableName> WHERE ?DfDynamicRangePartitionCondition AND <your_additional_where_clause>. Colonna di partizione: specificare la colonna usata per partizionare i dati. Limite superiore della partizione e limite inferiore della partizione (facoltativo): specificare se si desidera determinare lo stride della partizione. Non si tratta di filtrare le righe nella tabella, tutte le righe nel risultato della query verranno partizionate e copiate. Se non specificato, l'attività di copia rileva automaticamente il valore. Ad esempio, se la colonna di partizione "ID" include valori compresi tra 1 e 100 e si imposta il limite inferiore su 20 e il limite superiore come 80, con copia parallela come 4, il servizio recupera i dati per 4 partizioni- ID nell'intervallo <=20, [21, 50], [51, 80], e >=81 rispettivamente. Di seguito sono riportate altre query di esempio per diversi scenari: • Eseguire una query sull'intera tabella: SELECT * FROM <TableName> WHERE ?DfDynamicRangePartitionCondition • Eseguire una query da una tabella con la selezione di colonne e filtri aggiuntivi di clausola where: SELECT <column_list> FROM <TableName> WHERE ?DfDynamicRangePartitionCondition AND <your_additional_where_clause> • Eseguire query con sottoquery: SELECT <column_list> FROM (<your_sub_query>) AS T WHERE ?DfDynamicRangePartitionCondition AND <your_additional_where_clause> • Eseguire query con partizione nella sottoquery: SELECT <column_list> FROM (SELECT <your_sub_query_column_list> FROM <TableName> WHERE ?DfDynamicRangePartitionCondition) AS T

Procedure consigliate per caricare i dati con l'opzione di partizione:

• Scegliere una colonna distintiva come colonna di partizione (ad esempio chiave primaria o chiave univoca) per evitare l'asimmetria dei dati.
• Se la tabella include una partizione predefinita, usare l'opzione di partizione Partizioni fisiche della tabella per ottenere prestazioni migliori.
• Azure Synapse Analytics può eseguire un massimo di 32 query al momento, impostando grado di parallelismo di copia troppo grande può causare un problema di limitazione di Synapse.

Query di esempio per controllare la partizione fisica

SELECT DISTINCT s.name AS SchemaName, t.name AS TableName, c.name AS ColumnName, CASE WHEN c.name IS NULL THEN 'no' ELSE 'yes' END AS HasPartition
FROM sys.tables AS t
LEFT JOIN sys.objects AS o ON t.object_id = o.object_id
LEFT JOIN sys.schemas AS s ON o.schema_id = s.schema_id
LEFT JOIN sys.indexes AS i ON t.object_id = i.object_id
LEFT JOIN sys.index_columns AS ic ON ic.partition_ordinal > 0 AND ic.index_id = i.index_id AND ic.object_id = t.object_id
LEFT JOIN sys.columns AS c ON c.object_id = ic.object_id AND c.column_id = ic.column_id
LEFT JOIN sys.types AS y ON c.system_type_id = y.system_type_id
WHERE s.name='[your schema]' AND t.name = '[your table name]'

Se la tabella ha una partizione fisica, viene visualizzato "HasPartition" come "sì".

Riepilogo tabella

Le tabelle seguenti contengono altre informazioni sull'attività di copia in Azure Synapse Analytics.

Origine

Nome	Descrizione	Valore	Richiesto	Proprietà script JSON
Tipo di archivio dati	Tipo di archivio dati.	Esterno	Sì	/
Connessione	Connessione all'archivio dati di origine.	< connessione >	Sì	connection
Tipo di connessione	Tipo di connessione di origine.	Azure Synapse Analytics	Sì	/
Usare la query	Modalità di lettura dei dati.	•Tavolo •Query • Stored procedure	Sì	• typeProperties (in typeProperties ->source)   -Schema   -tavolo • sqlReaderQuery • sqlReaderStoredProcedureName   storedProcedureParameters   -Nome   -Valore
Timeout query	Il timeout per l'esecuzione del comando di query, il valore predefinito è 120 minuti.	timespan	No	queryTimeout
Livello di isolamento	Comportamento di blocco delle transazioni per l'origine SQL.	•Nessuno • Read committed • Read uncommitted • Lettura ripetibile •Serializzabile •Snapshot	No	Isolationlevel:   •Readcommitted • ReadUncommitted • RepeatableRead •Serializzabile •Snapshot
Opzione di partizione	Opzioni di partizionamento dei dati usate per caricare dati da database SQL di Azure.	•Nessuno • Partizioni fisiche della tabella • Intervallo dinamico   - Nome colonna partizione  - Limite superiore della partizione  - Limite inferiore della partizione	No	partitionOption:   • PhysicalPartitionsOfTable • DynamicRange   partition Impostazioni:   - partitionColumnName   - partitionUpperBound   - partitionLowerBound
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

Destinazione

Nome	Descrizione	Valore	Richiesto	Proprietà script JSON
Tipo di archivio dati	Tipo di archivio dati.	Esterno	Sì	/
Connessione	Connessione all'archivio dati di destinazione.	< connessione >	Sì	connection
Tipo di connessione	Tipo di connessione di destinazione.	Azure Synapse Analytics	Sì	/
Opzione Tabella	Opzione tabella dati di destinazione.	• Usa esistente • Creazione automatica tabella	Sì	• typeProperties (in typeProperties ->sink)   -Schema   -tavolo •Tableoption:   - Creazione automatica   typeProperties (in typeProperties ->sink)   -Schema   -tavolo
Metodo Copy	Metodo utilizzato per copiare i dati.	• Comando Copia • PolyBase • Inserimento bulk • Upsert	No	/
Quando si seleziona copia comando	Usare l'istruzione COPY per caricare dati da Archiviazione di Azure in Azure Synapse Analytics o nel pool SQL.	/	No. Applicare quando si usa COPY.	allowCopyCommand: true copyCommandSettings
Valori predefiniti	Specificare i valori predefiniti per ogni colonna di destinazione in Azure Synapse Analytics. I valori predefiniti nella proprietà sovrascrivono il vincolo DEFAULT impostato nel data warehouse e la colonna Identity non può avere un valore predefinito.	< valori predefiniti >	No	defaultValues:   -Columnname   -Defaultvalue
Opzioni aggiuntive	Opzioni aggiuntive che verranno passate a un'istruzione COPY di Azure Synapse Analytics direttamente nella clausola "With" nell'istruzione COPY. Racchiudere il valore tra virgolette come previsto dai requisiti dell'istruzione COPY.	< opzioni aggiuntive >	No	additionalOptions: - <nome> proprietà : <valore>
Quando si seleziona PolyBase	PolyBase è un meccanismo a velocità effettiva elevata. Usarlo per caricare grandi quantità di dati in Azure Synapse Analytics o nel pool SQL.	/	No. Applicare quando si usa PolyBase.	allowPolyBase: true polyBaseSettings
Tipo di rifiuto	Tipo del valore reject.	•Valore •Percentuale	No	rejectType: -Valore -Percentuale
Rifiuta valore	Numero o percentuale di righe che possono essere rifiutate prima che la query abbia esito negativo.	0 (impostazione predefinita), 1, 2 e così via.	No	rejectValue
Rifiutare il valore di esempio	Determina il numero di righe da recuperare prima che PolyBase ricalcoli la percentuale di righe rifiutate.	1, 2, ecc.	Sì quando si specifica Percentage come tipo di rifiuto	rejectSampleValue
Usa il tipo predefinito	Specificare come gestire i valori mancanti nei file di testo delimitati quando PolyBase recupera i dati dal file di testo. Altre informazioni su questa proprietà sono disponibili nella sezione Arguments in CREATE EXTERNAL FILE FORMAT (Transact-SQL)	selezionato (impostazione predefinita) o deselezionato.	No	useTypeDefault: true (impostazione predefinita) o false
Quando si seleziona Inserimento bulk	Inserire i dati nella destinazione in blocco.	/	No	writeBehavior: Insert
Blocco tabella inserimento bulk	Usare questa opzione per migliorare le prestazioni di copia durante l'operazione di inserimento bulk nella tabella senza indici da più client. Per altre informazioni, vedere BULK IN edizione Standard RT (Transact-SQL).	selezionato o non selezionato (impostazione predefinita)	No	sqlWriterUseTableLock: true o false (impostazione predefinita)
Quando si seleziona Upsert	Specificare il gruppo delle impostazioni per il comportamento di scrittura quando si desidera eseguire l'upsert dei dati nella destinazione.	/	No	writeBehavior: Upsert
Colonne chiave	Indica la colonna utilizzata per determinare se una riga dall'origine corrisponde a una riga dalla destinazione.	< nome colonna>	No	upsert Impostazioni:   - chiavi: < nome colonna >   - interimSchemaName
Blocco tabella inserimento bulk	Usare questa opzione per migliorare le prestazioni di copia durante l'operazione di inserimento bulk nella tabella senza indici da più client. Per altre informazioni, vedere BULK IN edizione Standard RT (Transact-SQL).	selezionato o non selezionato (impostazione predefinita)	No	sqlWriterUseTableLock: true o false (impostazione predefinita)
Script di pre-copia	Script per l'esecuzione dell'attività di copia prima di scrivere dati in una tabella di destinazione in ogni esecuzione. È possibile usare questa proprietà per pulire i dati precaricati.	< script di pre-copia > (string)	No	preCopyScript
Timeout del batch di scrittura	Tempo di attesa per il completamento dell'operazione di inserimento batch prima del timeout. Il valore consentito è timespan. Il valore predefinito è "00:30:00" (30 minuti).	timespan	No	writeBatchTimeout
Dimensioni batch di scrittura	Numero di righe da inserire nella tabella SQL per batch. Per impostazione predefinita, il servizio determina in modo dinamico le dimensioni del batch appropriate in base alle dimensioni della riga.	< numero di righe > (intero)	No	writeBatchSize
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.	< limite massimo di connessioni simultanee > (intero)	No	maxConcurrentConnections
Disabilitare l'analisi delle metriche delle prestazioni	Questa impostazione viene usata per raccogliere metriche, ad esempio DTU, DWU, UR e così via, per ottimizzare le prestazioni di copia e consigli. Se si è interessati a questo comportamento, selezionare questa casella di controllo.	selezionare o deselezionare (impostazione predefinita)	No	disableMetricsCollection: true o false (impostazione predefinita)

Contenuto correlato

• Panoramica del connettore di Azure Synapse Analytics