Condividi tramite

Comando .create-or-alter ingestion mapping

  • Articolo

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

Crea o modifica un mapping di inserimento che può essere associato a un formato specifico e a una tabella o a un database specifico.

Se il mapping di inserimento non esiste, il comando lo creerà. Se il mapping di inserimento esiste già, il comando lo modificherà.

Nota

Le nuove colonne introdotte in un mapping di inserimento, che non sono presenti nella tabella di origine, verranno aggiunte alla tabella durante l'inserimento iniziale dei dati per tale colonna. Questo comportamento è supportato solo per l'inserimento in coda e dipende dalla specifica di un tipo di dati valido per la colonna.

Autorizzazioni

Per creare un mapping di inserimento di database sono necessarie almeno le autorizzazioni di Ingestor del database e per creare un mapping di inserimento tabelle sono necessarie almeno le autorizzazioni Ingestor per creare un mapping di inserimento di tabelle.

Sintassi

.create-or-altertable Mapping Mapping Di TableName ingestion MappingName mapping MappingFormattedAsJson

.create-or-alterdatabase Mapping Mapping Di DatabaseName ingestion MappingName mapping MappingFormattedAsJson

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
TableName string ✔️ Nome della tabella.
DatabaseName string ✔️ Nome del database.
MappingKind string ✔️ Tipo di mapping. I valori validi sono CSV, JSON, avro, parquet e orc.
MappingName string ✔️ Nome del mapping.
MappingFormattedAsJson string ✔️ Definizione del mapping di inserimento formattata come valore JSON.

Nota

  • Dopo la creazione, è possibile fare riferimento al mapping in base al nome nei comandi di inserimento, anziché specificare il mapping completo come parte del comando.
  • Se viene creato un mapping con lo stesso nome sia nell'ambito della tabella che nell'ambito del database, il mapping nell'ambito della tabella avrà una priorità più alta.
  • Quando si inserisce in una tabella e si fa riferimento a un mapping il cui schema non corrisponde allo schema della tabella inserita, l'operazione di inserimento avrà esito negativo.

Esempio

.create table MyTable ingestion csv mapping "Mapping1"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

.create-or-alter table MyTable ingestion json mapping "Mapping1"
'['
'    { "column" : "rownumber", "datatype" : "int", "Properties":{"Path":"$.rownumber"}},'
'    { "column" : "rowguid", "Properties":{"Path":"$.rowguid"}}'
']'

Output

Nome Tipologia Mapping Database Tabella
mapping1 JSON [{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":""}] MyDatabase MyTable

Contenuto correlato

  • Per descrizioni dettagliate dei vari formati di mapping di inserimento, ad esempio CSV, JSON, Avro, Parquet e Orc, vedere Mapping dei dati.