.create table コマンド
新しい空のテーブルを作成します。
このコマンドは、特定のデータベースのコンテキストで実行する必要があります。
アクセス許可
このコマンドを実行するには、少なくとも Database User アクセス許可が必要です。
構文
.create
table
tableName (
columnName:
columnType [,
...] )
[with
(
propertyName =
propertyValue [,
...]] )
]
構文規則について詳しく知る。
パラメーター
件名 | タイプ | Required | 説明 |
---|---|---|---|
tableName | string |
✔️ | 作成するテーブルの名前です。 |
columnName, columnType | string |
✔️ | その列のデータ型にマップされた列の名前。 これらのマッピングの一覧では、出力列スキーマが定義されています。 |
propertyName, propertyValue | string |
キーと値のプロパティのペアのコンマ区切りのリスト。 サポートされるプロパティを参照してください。 |
サポートされるプロパティ
名前 | 種類 | 説明 |
---|---|---|
docstring |
string |
追加するエンティティを説明するフリー テキスト。 この文字列は、エンティティ名の横にあるさまざまな UX 設定で表示されます。 |
folder |
string |
テーブルに追加するフォルダーの名前。 |
Note
データベースのコンテキストに同じ (大文字と小文字を区別する) 名前のテーブルが既に存在する場合、次のシナリオでも、既存のテーブルを変更せずに成功を返します。
- 指定したスキーマが既存のテーブルのスキーマと一致しない
folder
またはdocstring
パラメーターは、テーブルに設定されている値とは異なる値で指定されます。
例
.create table MyLogs ( Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32 )
出力
次のように、テーブルのスキーマを JSON 書式で返します。
.show table MyLogs schema as json
Note
複数のテーブルを作成するには、 .create tables
コマンドを使用してパフォーマンスを向上させ、データ読み込みを減らします。