.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