はじめに
Domo Snowflake OAuth Internal Unload V2コネクターを使用すると、社内のS3を介してSnowflake Data WarehouseからDomoに、安全かつ簡単にデータを取り込むことができます。このコネクターを使用すると、データをSnowflakeデータベースから社内のAmazon S3にアンロードできます。次に、ファイルが社内のS3からDomoにダウンロードされます。このコネクターを使用するには、Snowflakeアカウント名と、クライアントの登録時にSnowflakeから提供されたクライアントIDおよびクライアントシークレットが必要です。SnowflakeのデータがDomoに入ると、他のすべてのDomoデータと組み合わせることで、最も重要なミッションデータを集約して表示できます。Snowflake APIの詳細については、 https://docs.snowflake.net/manuals を参照してください。 Snowflakeコネクターは、クエリを使用してデータベースからデータを取得する「データベース」コネクターです。Data Centerでは、ウィンドウ上部のツールバーで ［データベース］ をクリックすることで、これを含むデータベースコネクターのページにアクセスできます。 このトピックでは、Snowflake OAuth Internal Unload V2コネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加、更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「 コネクターを使用してDataSetを追加する 」を参照してください。ベストプラクティス
必要条件
Snowflakeアカウントに接続してDataSetを作成するには、以下が必要です。-
アカウントのフルネーム（Snowflakeにより提供）。これは、Snowflake URLの https://の 直後に続く部分です。
アカウントのフルネームには、アカウントがホストされる地域とクラウドプラットフォームを識別する追加のセグメントが含まれる場合があることに注意してください。以下の表に、クラウドプラットフォームまたは地域別のアカウント名の例を示します。各行に対して、アカウント名が「xy12345」であると仮定しています。
- クライアントの登録時にSnowflakeから提供されたクライアントIDおよびクライアントシークレット。
Snowflake アカウントに接続する
このセクションでは、 Snowflake OAuth Internal Unload V2 コネクターページの ［認証情報］ および ［詳細］ ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ペイン
このペインには、Snowflakeアカウントに接続するための認証情報を入力するフィールドがあります。下の表は、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
Account Name | Snowflakeアカウント名を入力します。アカウント名を検索する方法については、「必要条件」を参照してください。 |
Client ID | クライアントの登録時にSnowflakeから提供されたクライアントIDを入力します。 |
Client Secret | クライアントの登録時にSnowflakeから提供されたクライアントシークレットを入力します。 |
| Role | 権限を入力します。 |
［詳細］ペイン
このペインには、メインとなる ［Reports］ メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。メニュー | 説明 | ||||
|---|---|---|---|---|---|
Query Type | クエリタイプを選択します。
| ||||
| Warehouses | 取得したいデータが格納されているウェアハウスを選択します。このリストには、認証情報にもとづいてアクセスできるすべてのウェアハウスが表示されます。 | ||||
| Databases | 取得したいデータが格納されているデータベースを選択します。このリストには、認証情報にもとづいてアクセスできるすべてのデータベースが表示されます。 | ||||
| Schemas | 取得したいデータが含まれているデータベーススキーマを選択します。このリストには、認証情報にもとづいてアクセスできるすべてのスキーマが表示されます。 | ||||
| Database Objects | データベースオブジェクトを選択します。 | ||||
| Tables | 取得するデータベース表を選択します。このリストには、認証情報にもとづいてアクセスできるすべての表が表示されます。データベーステーブルを選択しない場合は、コネクターはデータベーススキーマ全体を取得します。 | ||||
| Table Columns | 取得したいテーブルの列を選択します。このリストには、認証情報にもとづいてアクセスできるすべての列が表示されます。表の列を選択しないと、コネクターは選択したデータベース表全体を取得します。 | ||||
| Table Query Helper | このフィールドには、選択したフィールドにもとづいて生成されたクエリが表示されます。 | ||||
| Views | ビューを選択します。 | ||||
| View Columns | レポートに含める表示列を選択します。 | ||||
| Query Helper | 上部のメニューから、ウェアハウス、データベース、スキーマ、表などを選択すると、利用可能なSQLクエリがこのフィールドに作成されます。このフィールドのSQLステートメントをコピーして、 ［Query］ フィールドに貼り付けます。 | ||||
| Fetch Size | メモリのパフォーマンスのフェッチサイズを入力します。空白にすると、デフォルトサイズの1000が適用されます。DataSetにメモリ不足のエラーが発生した場合は、フェッチサイズを小さくしてください。 | ||||
| Query | データを取得するために使用するSQLクエリを入力します。 ［Query Helper］ パラメーターを使用して、使用可能なSQLクエリを記述できます。 ［Query Helper］ を使用するには、以下を行います。
| ||||
| Partition Support | データをパーティションするかどうかを選択します。 | ||||
| Partition Criteria | 日付形式またはクエリを使用してデータをパーティションするかどうかを選択します。 | ||||
| Partition Query to determine partition tags | パーティションタグを特定するために、パーティションクエリを入力します。 日付 データを含む列は、パーティション列です。例：Table_Nameから 日付 を選択します。 | ||||
| Partition Support Format | パーティションの形式を選択します。 | ||||
| Partition Column Name | パーティション列の名前を入力します。 | ||||
| Past Years | データを取得する過去の年数を入力します。値はXとすることができ、この場合Xは正の整数です。例：30 | ||||
| Future Years | データを取得する未来の年数を入力します。値はXとすることができ、この場合Xは正の整数です。例：30 | ||||
| Past Months | データを取得する過去の月数を入力します。値はXとすることができ、この場合Xは正の整数です。例：30 | ||||
| Future Months | データを取得する未来の月数を入力します。値はXとすることができ、この場合Xは正の整数です。例：30 | ||||
| Past Days | データを取得する過去の日数を入力します。値はXとすることができ、この場合Xは正の整数です。例：30 | ||||
| Date Format | 必要な日付形式を選択します。デフォルトでは、 yyyy-MM-dd が使用されます。 | ||||
| Custom Date Format | カスタマイズされた日付形式を入力します。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。よくある質問
「OAuth access token expired」というエラーが発生しました。それはなぜですか？
「OAuth access token expired」というエラーが発生しました。それはなぜですか？
このエラーを避けるには、トークンを更新する必要があります。Snowflakeでは、アカウントが期限切れになるたびに手動でDomoアカウントを再接続する必要があります。アカウントの有効期限は、Snowflake統合によってコントロールされています。90日ごとに更新トークンが期限切れになるように設定されている場合、90日ごとにアカウントを再接続する必要があります。更新のタイムアウトを91日以上にしたい場合は、Snowflakeサポートに連絡する必要があります。タイムアウトは90日から最大1年に延長することができます。
このコネクターを作成するにはどのような認証情報が必要ですか？
このコネクターを作成するにはどのような認証情報が必要ですか？
アカウントのフルネームと、クライアントの登録時にSnowflakeから提供されたクライアントIDおよびクライアントシークレットが必要です。自分の権限を入力することもできます。
注意すべきAPI制限はありますか？
注意すべきAPI制限はありますか？
制限は使用するサーバー構成によって異なります。
データはどれくらいの頻度で更新されますか？
データはどれくらいの頻度で更新されますか？
DataSetは15分間隔で実行できます。ただし、クエリの実行時間によっては、DataSetの実行頻度を低くする必要があります。
クエリの記述の際に注意すべき点はありますか？
クエリの記述の際に注意すべき点はありますか？
すべての単語、テーブル名、フィールド名が正しく記述されていることを確認してください。クエリのヘルプについては、［クエリヘルパー］フィールドを参照してください。
Snowflakeデータベースに接続できない理由は？IPアドレスのホワイトリスト登録が必要でしょうか？
Snowflakeデータベースに接続できない理由は？IPアドレスのホワイトリスト登録が必要でしょうか？
Snowflakeデータベースに接続する前に、接続するポート上のデータベースサーバーにある多数のIPアドレスをホワイトリストに登録する必要があります。IPアドレスの詳細なリストは、「 ネットワーク接続にDomoのIPアドレスを許可する 」を参照してください。
Snowflake OAuthコネクターとSnowflake OAuth Internal Unload V2コネクターは、何が違うのですか？
Snowflake OAuthコネクターとSnowflake OAuth Internal Unload V2コネクターは、何が違うのですか？
Snowflake OAuth Internal Unload V2コネクターでは、パーティション分割がサポートされています。そのため、データをパーティション分割するかどうかを選択できます。また、日付形式またはクエリを使用して、データをパーティション分割するかどうかを選択することもできます。