Příkaz .create-merge table
Platí pro: ✅Microsoft Fabric✅Azure Data Explorer
Vytvoří novou tabulku nebo rozšíří existující tabulku.
Příkaz musí běžet 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-mergetable tableName (columnType: [, ...]) [with (propertyName = propertyValue [, ...]])
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
Pokud tabulka neexistuje, funguje přesně jako .create table příkaz.
Pokud tabulka T existuje a odešlete .create-merge table T (<columns specification>) příkaz, pak:
- Na konec schématu T se přidá libovolný sloupec ve <specifikaci> sloupců, který v T ještě neexistuje.
- Žádný sloupec, který není ve <specifikaci sloupců, se ze sloupce> T neodebere.
- Jakýkoli sloupec ve <specifikaci sloupců, který existuje ve sloupci> T, ale s jiným datovým typem způsobí selhání příkazu.