Opdracht voor toewijzing van .create-opname

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

Als er al een toewijzing met dezelfde naam in het opgegeven bereik bestaat, .create mislukt. Gebruik in plaats daarvan .create-or-alter.

Machtigingen

Er zijn ten minste Database Ingestor-machtigingen vereist voor het maken van een databaseopnametoewijzing en ten minste Table Ingestor-machtigingen zijn vereist om een tabelopnametoewijzing te maken.

Syntax

.createtableTableNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabasenaamingestionMappingKindmappingMappingNameMappingFormattedAsJson

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

Voorbeelden

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

.create database MyDatabase ingestion csv mapping "Mapping2"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

Uitvoer

Name	Soort	Toewijzing	Database	Tabel
mapping1	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	MyDatabase	Mytable
mapping2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	MyDatabase

Voorbeeld: .create-opnametoewijzing met escapetekens

.create table test_table ingestion json mapping "test_mapping_name"
'['
'{"column":"timeStamp","path":"$[\'timeStamp\']","datatype":"","transform":null},{"column":"name","path":"$[\'name\']","datatype":"","transform":null},{"column":"x-opt-partition-key","path":"$[\'x-opt-partition-key\']","datatype":"","transform":null}'
']'

Gerelateerde inhoud

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