データの登録¶
このトピックでは、 Snowflake Data Clean Room にリンクできるようにデータを登録する方法について説明します。
サポートされているオブジェクト¶
クリーンルームにリンクできるオブジェクトの種類は、ウェブアプリで作成するか、開発者 APIs を使用するかによって異なります。これらのタイプの特定のオブジェクトは、リンクする前に登録する必要があります。
- ウェブアプリ:
Snowflake Data Clean Rooms のウェブアプリは以下のオブジェクトをサポートしています。
テーブル
外部テーブル
Apache Iceberg™ テーブル
ビュー
マテリアライズドビュー
セキュアビュー。さらに、セキュアビューの所有者は SAMOOHA_APP_ROLE ロールでなければなりません。
- 開発者API:
Snowflake Data Clean Roomは Snowflake Native App Frameworkに依存しているため、Snowflake Native App Frameworkでサポートされている任意のオブジェクトをリンクできます。
注釈
外部テーブルとIcebergテーブルのクリーンルーム内での連結は明示的に許可されなければなりません。詳細については、 Snowflake Data Clean Rooms: 外部テーブルとIcebergテーブル をご参照ください。
データオブジェクトの登録¶
ユーザーがデータを Snowflake Data Clean Room にリンクする前に、データはデータベース、スキーマ、またはオブジェクトレベルで登録されなければなりません。データベースまたはスキーマを登録すると、そのデータベースまたはスキーマ内のすべてのオブジェクトが登録されます。
データベース、スキーマ、オブジェクトの登録には、 Snowsight または 開発者 APIs を使用します。 Snowsight を使う方が簡単ですが、 ACCOUNTADMIN ロールが必要です。開発者 APIs では、オブジェクトの所有者はアカウント管理者でなくても登録できます。
データベース、スキーマ、またはオブジェクトを登録すると、 SAMOOHA_APP_ROLE ロールにアクセスできるようになります。これは、開発者が開発者 APIs を実行するときに使用するロールです。
注釈
データベースやスキーマを登録しても、登録 後 に追加されたオブジェクトは自動的に登録されません。新しいオブジェクトを個別に登録するか、ウェブアプリの Snowflake Admin オプションを使って Database Registration セクションに戻り、 Resync を選択する必要があります。
Snowsight へのデータの登録¶
Snowsight にデータベース、スキーマ、オブジェクトを登録するには、次のようにします。
Admin » Snowflake Admin を選択します。
Login to Snowflake を選択し、 ACCOUNTADMIN ロールを持つユーザーとして認証します。
Database Registration セクションで、 Edit を選択し、データベース、スキーマ、またはオブジェクトを選択します。
Save を選択します。
開発者 APIs を使用したデータの登録¶
開発者 APIs は、アカウント管理者はデータベース、スキーマ、オブジェクトをプログラムで登録できるようにします。データベース、スキーマ、オブジェクトの所有者が登録できます。
以下の APIs が利用可能です。
タスク |
API |
入力 |
---|---|---|
データベースの登録 |
|
データベース名(string) |
スキーマの登録 |
|
スキーマ名(文字列の配列) |
管理アクセススキーマの登録 |
|
管理アクセススキーマ名(文字列の配列) |
任意のタイプのオブジェクトの登録 |
|
|
テーブルの登録 |
|
テーブル名(文字列の配列) |
ビューの登録 |
|
ビュー名(文字列の配列) |
管理アクセススキーマへのテーブルの登録 |
|
テーブル名(文字列の配列) |
管理アクセススキーマへのビューの登録 |
|
ビュー名(文字列の配列) |
例えば、スキーマ MY_SCHEMA
の所有者は、ワークシートで以下のコマンドを実行することにより、そのスキーマを登録することができます。
CALL samooha_by_snowflake_local_db.library.register_schema(['MY_DB.MY_SCHEMA']);
開発者 APIs を使用したデータの登録解除¶
以下の APIs を使用して、データベース、スキーマ、オブジェクトの登録解除を行うことができます。
タスク |
API |
入力 |
---|---|---|
データベースの登録解除 |
|
データベース名(string) |
スキーマの登録解除 |
|
スキーマ名(文字列の配列) |
管理アクセススキーマの登録解除 |
|
管理アクセススキーマ名(文字列の配列) |
あらゆるタイプのオブジェクトの登録解除 |
|
|
テーブルの登録解除 |
|
テーブル名(文字列の配列) |
ビューの登録解除 |
|
ビュー名(文字列の配列) |
管理アクセススキーマのテーブルの登録解除 |
|
テーブル名(文字列の配列) |
管理アクセススキーマのビューの登録解除 |
|
ビュー名(文字列の配列) |