Condividi tramite


Configurare il database KQL in un'attività di copia

Questo articolo illustra come usare l'attività di copia nelle pipeline di Azure Data Factory e Synapse Analytics per copiare i dati da un database KQL.

Configurazione supportata

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

Generali

Per configurazione della scheda Generale, passare a Generale.

Origine

Le proprietà seguenti sono supportate per il database KQL nella scheda Origine di un'attività di copia.

Screenshot che mostra la scheda Origine e l'elenco delle proprietà.

Per ogni oggetto sono necessarie le proprietà seguenti:

  • Tipo di archivio dati: selezionare Area di lavoro.

  • Tipo di archivio dati dell'area di lavoro: selezionare Database KQL dall'elenco dei tipi di archivio dati.

  • Database KQL: selezionare un database KQL esistente dall'area di lavoro.

  • Usare query: selezionare Tabella o Query.

    • Tabella: selezionare una tabella dall'elenco a discesa o selezionare Modifica per immetterla manualmente per leggere i dati.

      Screenshot che mostra la tabella.

    • Query: specificare la richiesta di sola lettura specificata in un formato KQL. Usare la query KQL personalizzata come riferimento.

      Screenshot che mostra la query.

Sotto Avanzate, è possibile specificare i campi seguenti:

  • Timeout Query: il tempo di attesa prima del timeout della richiesta di query. Il valore predefinito è 10 minuti (00:10:00). Il valore massimo consentito è 1 ora (01:00:00).

  • Nessuna troncatura: indica se troncare il set di risultati restituito. Per impostazione predefinita, il risultato viene troncato dopo 500.000 record o 64 MB. Il troncamento è fortemente consigliato per garantire il comportamento corretto dell'attività.

  • 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.

    Screenshot che mostra colonne aggiuntive.

Destinazione

Le proprietà seguenti sono supportate per il database KQL nella scheda Destinazione di un'attività di copia.

Screenshot che mostra la scheda Destinazione.

Per ogni oggetto sono necessarie le proprietà seguenti:

  • Tipo di archivio dati: selezionare Area di lavoro.
  • Tipo di archivio dati dell'area di lavoro: selezionare Database KQL dall'elenco dei tipi di archivio dati.
  • Database KQL: selezionare un database KQL esistente dall'area di lavoro.
  • Tabella: selezionare una tabella dall'elenco a discesa o selezionare Modifica per immetterla manualmente per scrivere i dati.

Sotto Avanzate, è possibile specificare i campi seguenti:

  • Nome mapping inserimento: nome di un mapping creato in anticipo e assegnato a una tabella di destinazione del database KQL.

  • Proprietà aggiuntive: un contenitore di proprietà che può essere usato per specificare qualsiasi proprietà di ingestione che non sia già stata impostata dalla destinazione del database KQL. In particolare, può essere utile per specificare i tag di inserimento. Per altre informazioni, vedere la inserimento dati di Esplora dati di Azure.

    Screenshot che mostra proprietà aggiuntive.

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.

Tabella di riepilogo

Le tabelle seguenti contengono altre informazioni su un'attività di copia in un database KQL.

Informazioni sull'origine

Nome Descrizione valore Richiesto Proprietà script JSON
Tipo di archivio dati Tipo di archivio dati. Area di lavoro /
Tipo di archivio dati dell'area di lavoro Selezionare Database KQL dall'elenco dei tipi di archivio dati. Database KQL /
Database KQL Selezionare un database KQL esistente nell'area di lavoro. <database KQL> /
Usa query Selezionare Tabella o Query. Tabella
Query
No table
query
Timeout query Specifica il tempo di attesa prima del timeout della richiesta di query. Il valore predefinito è 10 minuti (00:10:00). Il valore massimo consentito è 1 ora (01:00:00). timespan No queryTimeout
Nessun troncamento Indica se troncare il set di risultati restituito. Per impostazione predefinita, il risultato viene troncato dopo 500.000 record o 64 MB. Il troncamento è fortemente consigliato per garantire il comportamento corretto dell'attività. selezionare o deselezionare No noTruncation: true o false
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. Maggiori informazioni su Aggiungere altre colonne durante la copia. • Nome
• Valore
No additionalColumns:
• Nome
• Valore

Informazioni sulla destinazione

Nome Descrizione valore Richiesto Proprietà script JSON
Tipo di archivio dati Tipo di archivio dati. Area di lavoro /
Tipo di archivio dati dell'area di lavoro Selezionare Database KQL dall'elenco dei tipi di archivio dati. Database KQL /
Database KQL Selezionare un database KQL esistente nell'area di lavoro. <database KQL> /
Tabella Tabella dei dati di destinazione per scrivere dati. <nome alla tua tabella> table
Nome mapping inserimento Nome di un mapping creato in anticipo e assegnato alla tabella di destinazione del database KQL. <nome del mapping di inserimento> ingestionMappingName
Proprietà aggiuntive Un contenitore di proprietà che può essere usato per specificare qualsiasi proprietà di ingestione che non sia già stata impostata dalla destinazione del database KQL. In particolare, può essere utile per specificare i tag di inserimento. Maggiori informazioni su Inserimento dati di Esplora dati di Azure. • Nome
• Type
• Valore
additionalProperties