Udostępnij za pośrednictwem


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

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