.create table based-on command
Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer
Tworzy nową pustą tabelę na podstawie istniejącej tabeli. To polecenie musi być uruchamiane w kontekście określonej bazy danych.
Uwaga
Wszystkie właściwości tabeli źródłowej są kopiowane do nowej tabeli z następującymi wyjątkami:
- Aktualizowanie zasad
- Autoryzowane podmioty zabezpieczeń: w przypadku korzystania z
.create table based-on
polecenia bieżący podmiot zabezpieczeń jest dodawany do administratorów tabeli.
Uprawnienia
Aby uruchomić to polecenie, musisz mieć co najmniej uprawnienia administratora bazy danych.
Składnia
.create
tableName based-on
otherTable [ifnotexists
] [with
(
propertyName =
propertyValue [,
...])
]table
Dowiedz się więcej na temat konwencji składni.
Parametry
Nazwisko | Type | Wymagania | opis |
---|---|---|---|
ifnotexists |
string |
Jeśli zostanie określona, tabela zostanie utworzona tylko wtedy, gdy jeszcze nie istnieje. | |
tableName | string |
✔️ | Nazwa tabeli do utworzenia. Nazwa wielkości liter musi być unikatowa w bazie danych. |
otherTable | string |
✔️ | Nazwa istniejącej tabeli, która ma być używana jako źródło kolumn, ściągnięć i folder tworzonej tabeli. |
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. Wartość domyślna to Utworzono na <podstawie tableName>. |
folder |
string |
Nazwa folderu, w którym ma zostać dodana tabela. Wartość domyślna to ten sam folder co nazwa_tabeli. |
Zwraca
To polecenie zwraca schemat nowej tabeli w formacie JSON, podobnie jak w przypadku uruchomienia następującego polecenia:
.show table MyLogs schema as json
Uwaga
- Jeśli tabela już istnieje:
- Jeśli
ifnotexists
określono flagę, polecenie jest ignorowane (nie zastosowano żadnych zmian). - Jeśli
ifnotexists
nie określono flagi, zwracany jest błąd.
- Jeśli
Przykład
.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")