Polecenie .create-merge tables

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Umożliwia tworzenie i rozszerzanie schematów istniejących tabel w ramach pojedynczej operacji zbiorczej w kontekście określonej bazy danych.

Uprawnienia

To polecenie wymaga uprawnień użytkownika bazy danych i uprawnień administratora tabeli do rozszerzania istniejących tabel.

Składnia

.create-mergetables tableName1( columnName:columnType [, ...] [, tableName2( columnType: [, ...])) ... ] [with (propertyName = propertyValue [, ...]])

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

Parametry

Nazwisko	Type	Wymagania	opis
tableName	string	✔️	Nazwa tabeli do utworzenia lub rozszerzenia.
columnName, columnType	string	✔️	Nazwa istniejącej lub nowej kolumny zamapowana na typ danych w tej kolumnie. Lista mapowań definiuje schemat kolumn wyjściowych.
propertyName, propertyValue	string		Rozdzielona przecinkami lista par właściwości klucz-wartość. Zobacz obsługiwane właściwości.

Obsługiwane właściwości

Nazwisko	Pisz	Opis
docstring	string	Dowolny tekst opisujący jednostkę do dodania. Ten ciąg jest wyświetlany w różnych ustawieniach środowiska użytkownika obok nazw jednostek.
folder	string	Nazwa folderu, który ma zostać dodany do tabeli.

Zwraca

• Zostaną utworzone określone tabele, które nie istnieją.
• Określone tabele, które już istnieją, będą miały rozszerzone schematy.
  • Kolumny nieistniejących są dodawane na końcu schematu istniejącej tabeli.
  • Istniejące kolumny, które nie są określone w poleceniu, nie zostaną usunięte ze schematu istniejącej tabeli.
  • Istniejące kolumny określone za pomocą typu danych w poleceniu, które różnią się od kolumn w schematach istniejącej tabeli, prowadzą do błędu. Nie są tworzone żadne tabele.

Przykład

.create-merge tables 
  MyLogs (Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32),
  MyUsers (UserId:string, Name:string)

Wyjście

tableName	DatabaseName	Folder	DocString
Moje dzienniki	TopComparison
MyUsers	TopComparison