.create-merge table コマンド
新しいテーブルを作成するか、既存のテーブルを拡張します。
このコマンドは、特定のデータベースのコンテキストで実行する必要があります。
アクセス許可
このコマンドには Database User 権限と、既存のテーブルを拡張するための Table Admin 権限が必要です。
構文
.create-mergetable tableName (columnName:columnType [, ...] ) [with (propertyName = propertyValue [, ...]] )]
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| tableName | string |
✔️ | 作成または拡張するテーブルの名前。 |
| columnName, columnType | string |
✔️ | その列のデータ型にマップされた既存または新しい列の名前。 マッピングの一覧では、出力列スキーマが定義されます。 |
| propertyName, propertyValue | string |
キーと値のプロパティのペアのコンマ区切りのリスト。 サポートされるプロパティを参照してください。 |
サポートされるプロパティ
| 名前 | 種類 | 説明 |
|---|---|---|
docstring |
string |
追加するエンティティを説明するフリー テキスト。 この文字列は、エンティティ名の横にあるさまざまな UX 設定で表示されます。 |
folder |
string |
テーブルに追加するフォルダーの名前。 |
返品
テーブルが存在しない場合は、.create table コマンドとまったく同じように機能します。
テーブル T が存在するときに .create-merge table T (<columns specification>) コマンドを送信した場合、次のようになります。
- 以前に T に存在しなかった <columns specification> 内の列は、T のスキーマの最後に追加されます。
- T の列が <列の指定に含まれていない場合> は T から削除されません。
- <columns specification> 内の列が T に存在する一方で、そのデータ型が異なる場合、コマンドは失敗します。