Polecenie .create table
Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer
Tworzy nową pustą tabelę.
Polecenie musi zostać uruchomione w kontekście określonej bazy danych.
Uprawnienia
Aby uruchomić to polecenie, musisz mieć co najmniej uprawnienia użytkownika bazy danych.
Składnia
.create
tableName columnName:
(
columnType [,
...])
[with
(
propertyName =
propertyValue [,
...]])
table
Dowiedz się więcej na temat konwencji składni.
Parametry
Nazwisko | Type | Wymagania | opis |
---|---|---|---|
tableName | string |
✔️ | Nazwa tabeli do utworzenia. |
columnName, columnType | string |
✔️ | Nazwa kolumny mapowanej na typ danych w tej kolumnie. Lista tych mapowań definiuje schemat kolumn wyjściowych. |
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. |
folder |
string |
Nazwa folderu, który ma zostać dodany do tabeli. |
Uwaga
Jeśli tabela o tej samej nazwie (z uwzględnieniem wielkości liter) już istnieje w kontekście bazy danych, polecenie zwróci powodzenie bez zmiany istniejącej tabeli, nawet w następujących scenariuszach:
- Określony schemat nie jest zgodny ze schematem istniejącej tabeli
- Parametry
folder
lubdocstring
są określane przy użyciu wartości innych niż te ustawione w tabeli
Przykład
.create table MyLogs ( Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32 )
Wyjście
Zwraca schemat tabeli w formacie JSON, taki sam jak:
.show table MyLogs schema as json
Uwaga
Aby utworzyć wiele tabel, użyj .create tables
polecenia , aby uzyskać lepszą wydajność i mniejsze obciążenie danych.