Udostępnij za pośrednictwem


.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:

Uprawnienia

Aby uruchomić to polecenie, musisz mieć co najmniej uprawnienia administratora bazy danych.

Składnia

.createtableName 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.

Przykład

.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")