Příkaz .create table based-on
Platí pro: ✅Microsoft Fabric✅Azure Data Explorer
Vytvoří novou prázdnou tabulku založenou na existující tabulce. Tento příkaz musí běžet v kontextu konkrétní databáze.
Poznámka:
Všechny vlastnosti zdrojové tabulky se zkopírují do nové tabulky s následujícími výjimkami:
- Aktualizace zásad
- Autorizované objekty zabezpečení: Při použití
.create table based-on
příkazu se aktuální objekt zabezpečení přidá do správců tabulek.
Oprávnění
Ke spuštění tohoto příkazu musíte mít alespoň oprávnění správce databáze.
Syntaxe
.create
tableName based-on
otherTable [ifnotexists
] [with
(
propertyName =
propertyValue [,
...])
]table
Přečtěte si další informace o konvencích syntaxe.
Parametry
Název | Type | Požadováno | Popis |
---|---|---|---|
ifnotexists |
string |
Pokud je tato hodnota zadaná, vytvoří se pouze v případě, že ještě neexistuje. | |
tableName | string |
✔️ | Název tabulky, která se má vytvořit. Název senestivních písmen musí být v databázi jedinečný. |
jiná tabulka | string |
✔️ | Název existující tabulky, která se má použít jako zdroj pro sloupce, řetězec docstring a složku vytvářené tabulky. |
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. Výchozí hodnota je vytvořená na< základě tableName>. |
folder |
string |
Název složky, do které chcete tabulku přidat. Výchozí hodnota je stejná složka jako tableName. |
Návraty
Tento příkaz vrátí schéma nové tabulky ve formátu JSON, podobně jako spuštění následujícího příkazu:
.show table MyLogs schema as json
Poznámka:
- Pokud tabulka již existuje:
- Pokud
ifnotexists
je zadán příznak, příkaz se ignoruje (bez použití změny). - Pokud
ifnotexists
není zadán příznak, vrátí se chyba.
- Pokud
Příklad
.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")