Toewijzingsopdracht voor .create-or-alter ingestion

Hiermee maakt of wijzigt u een opnametoewijzing die kan worden gekoppeld aan een specifieke indeling en een specifieke tabel of database.

Als de opnametoewijzing niet bestaat, wordt deze door de opdracht gemaakt. Als de opnametoewijzing al bestaat, wordt deze door de opdracht gewijzigd.

Notitie

Nieuwe kolommen die zijn geïntroduceerd in een opnametoewijzing, die niet aanwezig zijn in de brontabel, worden aan de tabel toegevoegd tijdens de eerste gegevensopname voor die kolom. Dit gedrag wordt alleen ondersteund voor opname in de wachtrij en is afhankelijk van het opgeven van een geldig gegevenstype voor de kolom.

Machtigingen

Er zijn ten minste Database Ingestor-machtigingen vereist om een toewijzing van databaseopname te maken en ten minste Table Ingestor-machtigingen zijn vereist om een tabelopnametoewijzing te maken.

Syntax

.create-or-altertableTableNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.create-or-alterdatabaseDatabasenaamingestionMappingKindmappingMappingNameMappingFormattedAsJson

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
TableName	string	✔️	De naam van de tabel.
Databasenaam	string	✔️	De naam van de database.
MappingKind	string	✔️	Het type toewijzing. Geldige waarden zijn CSV, JSON, avro, parqueten orc.
MappingName	string	✔️	De naam van de toewijzing.
MappingFormattedAsJson	string	✔️	De definitie van de opnametoewijzing die is opgemaakt als een JSON-waarde.

Notitie

• Na het maken kan naar de toewijzing worden verwezen door de naam in opnameopdrachten, in plaats van de volledige toewijzing op te geven als onderdeel van de opdracht.
• Als een toewijzing met dezelfde naam wordt gemaakt in zowel het tabelbereik als het databasebereik, heeft de toewijzing in het tabelbereik een hogere prioriteit.
• Wanneer u in een tabel opneemt en verwijst naar een toewijzing waarvan het schema niet overeenkomt met het opgenomen tabelschema, mislukt de opnamebewerking.

Voorbeeld

.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"}}'
']'

Uitvoer

Name	Soort	Toewijzing	Database	Tabel
toewijzing1	JSON	[{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":""}]	MyDatabase	Mytable

Gerelateerde inhoud

• Zie Gegevenstoewijzingen voor gedetailleerde beschrijvingen van verschillende indelingen voor opnametoewijzing, zoals CSV, JSON, Avro, Parquet en Orc.