Comando di mapping di inserimento con estensione create-or-alter

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.