Udostępnij za pośrednictwem

Polecenie mapowania pozyskiwania .create-or-alter

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

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

Jeśli mapowanie pozyskiwania nie istnieje, polecenie go utworzy. Jeśli mapowanie pozyskiwania już istnieje, polecenie go zmodyfikuje.

Uwaga

Nowe kolumny wprowadzone w mapowaniu pozyskiwania, które nie są obecne w tabeli źródłowej, zostaną dodane do tabeli podczas początkowego pozyskiwania danych dla tej kolumny. To zachowanie jest obsługiwane tylko w przypadku pozyskiwania w kolejce i zależy od określenia prawidłowego typu danych dla kolumny.

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

.create-or-altertable TableName MappingKind mapping MappingName ingestion MappingNameFormattedAsJson

.create-or-alterdatabase 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ład

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

Wyjście

Nazwisko Rodzaj Mapowanie baza danych Table
mapowanie1 JSON [{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":""}] MyDatabase MyTable

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.