.create-merge table コマンド

新しいテーブルを作成するか、既存のテーブルを拡張します。

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

アクセス許可

このコマンドには、データベース ユーザーのアクセス許可と、既存のテーブルを拡張するためのテーブル 管理アクセス許可が必要です。

構文

.create-mergetableTablename(Columnname:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

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

パラメーター

名前	型	必須	説明
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