.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 に存在する一方で、そのデータ型が異なる場合、コマンドは失敗します。

関連するコンテンツ

• .create-merge tables
• .create table