Příkaz .create-merge tables

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Umožňuje vytvářet a rozšiřovat schémata existujících tabulek v jedné hromadné operaci v kontextu konkrétní databáze.

Oprávnění

Tento příkaz vyžaduje oprávnění uživatele databáze a oprávnění správce tabulky k rozšíření existujících tabulek.

Syntaxe

.create-mergetables tableName1 (columnType: [, ...]) [ , tableName2 (columnType: [, ...]) ... ] [with (propertyNameValue = [, ...]])

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Type	Požadováno	Popis
tableName	string	✔️	Název tabulky, která se má vytvořit nebo rozšířit
columnName, columnType	string	✔️	Název existujícího nebo nového sloupce namapovaného na typ dat v daném sloupci. Seznam mapování definuje schéma výstupního sloupce.
propertyName, propertyValue	string		Čárkami oddělený seznam párů vlastností klíč-hodnota. Viz podporované vlastnosti.

Podporované vlastnosti

Name	Typ	Popis
docstring	string	Volný text popisující entitu, která se má přidat. Tento řetězec se zobrazí v různých nastaveních uživatelského prostředí vedle názvů entit.
folder	string	Název složky, která se má přidat do tabulky.

Návraty

• Zadané tabulky, které neexistují, se vytvoří.
• Zadané tabulky, které již existují, budou mít svá schémata rozšířena.
  • Neexistující sloupce se přidají na konec schématu existující tabulky.
  • Existující sloupce, které nejsou zadané v příkazu, se ze schématu existující tabulky neodeberou.
  • Existující sloupce zadané s datovým typem v příkazu, které se liší od sloupce ve schématech existující tabulky, vedou k selhání. Nejsou vytvořeny žádné tabulky.

Příklad

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

Výstup

tableName	DatabaseName	Složka	DocString
Mojelogy	TopComparison
MyUsers	TopComparison