はじめに
Snowflake OAuth Unloadは、クラウドベースのアナリティクスデータウェアハウスシステムです。DomoのSnowflake OAuth Unloadコネクターを使用すると、SnowflakeデータベースからAmazon S3にデータをアンロードできます。ファイルはS3からDomoにダウンロードされます。このコネクターを使用するには、Snowflakeアカウント名と、クライアントの登録時にSnowflakeから提供されたクライアントIDおよびクライアントシークレットが必要です。非常に大きなクエリを実行している場合は、このコネクターがSnowflakeコネクターよりも優先されます。Snowflake APIの詳細については、 https://docs.snowflake.net/manuals を参照してください。 Snowflake OAuth Unloadコネクターは、クエリを使用してデータベースからデータを取得する「データベース」コネクターです。Data Centerでは、ウィンドウ上部のツールバーで ［データベース］ をクリックすることで、このコネクターやその他のデータベースコネクターのページにアクセスできます。 Snowflakeアカウントへの接続は、Data Centerで行います。このトピックでは、Snowflake OAuth Unloadコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加、更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「 コネクターを使用してDataSetを追加する 」を参照してください。ベストプラクティス
必要条件
Snowflakeアカウントに接続してDataSetを作成するには、以下が必要です。- アカウントのフルネーム（Snowflakeにより提供）。これは、Snowflake URLの https://の 直後に続く部分です。 アカウントのフルネームはアカウントがホストされる地域とクラウドプラットフォームを識別する追加のセグメントが含まれる場合があることに注意してください。以下の表に、クラウドプラットフォームまたは地域別のアカウント名の例を示します。各行に対して、アカウント名が「xy12345」であると仮定しています。
- クライアントの登録時にSnowflakeから提供されたクライアントID。
- クライアントの登録時にSnowflakeから提供されたクライアントシークレット。
- AWSアクセスキー。これは、AWSコンソールの ［Security Credentials］ セクションで、または IAM を使用している場合は ［Users］ で確認できます。
- アクセスキーの作成時に提供されたAWSシークレットキー。新しいシークレットキーは、AWSコンソールで生成できます。
- SnowflakeデータがアンロードされるAWS S3バケットの名前。
- S3バケットリージョン。
Snowflakeアカウントに接続する
このセクションでは、 Snowflake OAuth Unload コネクターページの ［認証情報］ および ［詳細］ ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ペイン
このペインには、Snowflakeアカウントに接続するための認証情報を入力するフィールドがあります。下の表は、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
Account Name | Snowflakeアカウント名を入力します。アカウント名を検索する方法については、「必要条件」を参照してください。 |
| Client ID | クライアントの登録時にSnowflakeから提供されたクライアントIDを入力します。 |
| Client Secret | クライアントの登録時にSnowflakeから提供されたクライアントシークレットを入力します。 |
| Access Key | AWSアクセスキーを入力します。これは、AWSコンソールの［Security Credentials］セクションで、またはIAMを使用している場合は［Users］で確認できます。 |
| Secret Key | AWSシークレットアクセスキーを入力します。これは、アクセスキーを作成した時に提供されたものです。新しいキーは、AWSコンソールで生成できます。 |
| Bucket | SnowflakeデータがアンロードされるAWS S3バケットの名前を入力します。 |
| Region | S3バケットリージョンを選択します。 |
| Role | 自分の権限を入力します。 |
［詳細］ペイン
このペインには、メインとなる ［Reports］ メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。メニュー | 説明 |
|---|---|
| Query | 実行するSQLクエリを入力します。 |
| Warehouses | ウェアハウスを選択します。 |
| Databases | データベースを選択します。 |
| Database Schema | スキーマを選択します。 |
| Database Tables | データベース表を選択します。 |
| Table Columns | レポートに含める表の列を選択します。 |
| Query Helper | クエリの作成にサポートが必要な場合は、このクエリをコピーして［Query］フィールドに貼り付けます。［Database Table］で表を、［Table Columns］で列を選択すると、このクエリが自動的に生成されます。 |
| Use Snowflake Schema | Domoにスキーマを決めさせるのではなく、Snowflakeのスキーマを直接使用したいときに、これをオンにします。 |