Share via

.create table コマンド

  • [アーティクル]

新しい空のテーブルを作成します。

コマンドは、特定のデータベースのコンテキストで実行する必要があります。

アクセス許可

このコマンドを実行するには、少なくとも データベース ユーザー のアクセス許可が必要です。

構文

.createtableTablename(Columnname:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

構文規則について詳しく知る。

パラメーター

名前 型 必須 説明
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 を使用します。