Udostępnij przez

.create ingestion mapping command (Polecenie tworzenia mapowania pozyskiwania)

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Tworzy mapowanie pozyskiwania, które może być skojarzone z określonym formatem i określoną tabelą lub bazą danych.

Jeśli mapowanie o tej samej nazwie w danym zakresie już istnieje, .create nie powiedzie się. Użycie w zamian parametru .create-or-alter.

Uprawnienia

Do utworzenia mapowania pozyskiwania bazy danych są wymagane co najmniej uprawnienia ingestor bazy danych, a co najmniej uprawnienia ingestora tabel są wymagane do utworzenia mapowania pozyskiwania tabel.

Składnia

.createtable TableName MappingKind mapping MappingName ingestion MappingNameFormattedAsJson

.createdatabase DatabaseName MappingKind mapping MappingName ingestion MappingFormattedAsJson

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
TableName string ✔️ Nazwa tabeli.
Nazwa bazy danych string ✔️ Nazwa bazy danych.
MappingKind string ✔️ Typ mapowania. Prawidłowe wartości to csv, , avrojson, parquet, i orc.
Nazwa mapowania string ✔️ Nazwa mapowania.
MappingFormattedAsJson string ✔️ Definicja mapowania pozyskiwania sformatowana jako wartość JSON.

Uwaga

  • Po utworzeniu mapowanie można odwoływać się do jego nazw w poleceniach pozyskiwania, zamiast określać pełne mapowanie w ramach polecenia .
  • Jeśli mapowanie o tej samej nazwie zostanie utworzone zarówno w zakresie tabeli, jak i w zakresie bazy danych, mapowanie w zakresie tabeli będzie miało wyższy priorytet.
  • Podczas pozyskiwania do tabeli i odwoływania się do mapowania, którego schemat nie jest zgodny ze schematem pozyskanej tabeli, operacja pozyskiwania zakończy się niepowodzeniem.

Przykłady

Tworzenie tabeli i bazy danych przy użyciu mapowania pozyskiwania woluminów CSV

Poniższy przykład tworzy tabelę MyTable z mapowaniem pozyskiwania woluminów CSV i bazą danych z MyDatabase mapowaniem Mapping1 Mapping2pozyskiwania woluminów CSV.

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

Wyjście

Nazwisko Rodzaj Mapowanie baza danych Table
mapowanie1 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] MyDatabase MyTable
mapowanie2 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] MyDatabase

Tworzenie mapowania pozyskiwania z znakami ucieczki

Poniższy przykład tworzy tabelę test_table z mapowaniem test_mapping_namepozyskiwania danych JSON. Aby uniknąć błędów, ukośniki odwrotne są używane do ucieczki pojedynczych cudzysłowów w ciągach ścieżki JSON.

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

Powiązana zawartość

  • Aby uzyskać szczegółowe opisy różnych formatów mapowania pozyskiwania, takich jak CSV, JSON, Avro, Parquet i Orc, zobacz Mapowania danych.
  • Aby dowiedzieć się więcej na temat mapowania JSON jako źródła pozyskiwania, zobacz Mapowanie JSON
  • Last updated on