> ## Documentation Index > Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Snowflake OAuth Internal Unload V2コネクター ## はじめに 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](https://docs.snowflake.com/ja "https://docs.snowflake.com/ja") を参照してください。 Snowflakeコネクターは、クエリを使用してデータベースからデータを取得する「データベース」コネクターです。Data Centerでは、ウィンドウ上部のツールバーで **［データベース］** をクリックすることで、これを含むデータベースコネクターのページにアクセスできます。 このトピックでは、Snowflake OAuth Internal Unload V2コネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加、更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。 ## ベストプラクティス **重要：** Snowflakeでは、アカウントが期限切れになるたびに手動でDomoアカウントを再接続する必要があります。アカウントの有効期限は、Snowflake統合によってコントロールされています。90日ごとに更新トークンが期限切れになるように設定されている場合、90日ごとにアカウントを再接続する必要があります。更新のタイムアウトを91日以上にしたい場合は、 **Snowflakeサポート** に連絡する必要があります。タイムアウトは90日から最大1年に延長することができます。 ## 必要条件 Snowflakeアカウントに接続してDataSetを作成するには、以下が必要です。 * アカウントのフルネーム（Snowflakeにより提供）。これは、Snowflake URLの [https://の](https://の) 直後に続く部分です。 アカウントのフルネームには、アカウントがホストされる地域とクラウドプラットフォームを識別する追加のセグメントが含まれる場合があることに注意してください。以下の表に、クラウドプラットフォームまたは地域別のアカウント名の例を示します。各行に対して、アカウント名が「xy12345」であると仮定しています。 Region.png * クライアントの登録時にSnowflakeから提供されたクライアントIDおよびクライアントシークレット。 ## Snowflake アカウントに接続する このセクションでは、 Snowflake OAuth Internal Unload V2 コネクターページの **［認証情報］** および **［詳細］** ペインのオプションについて説明します。このページのほかのペインの項目である **［スケジュール設定］** や **［DataSetに名前を付け、説明を入力］** に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。 ### ［認証情報］ペイン このペインには、Snowflakeアカウントに接続するための認証情報を入力するフィールドがあります。下の表は、各フィールドに必要な内容を説明しています。

フィールド

説明

Account Name

Snowflakeアカウント名を入力します。アカウント名を検索する方法については、「必要条件」を参照してください。

Client ID

クライアントの登録時にSnowflakeから提供されたクライアントIDを入力します。

Client Secret

クライアントの登録時にSnowflakeから提供されたクライアントシークレットを入力します。

Role 権限を入力します。
有効なSnowflake認証情報を一度入力しておくと、いつでも同じアカウントを使用して新しい Snowflake OAuth Internal Unload V2 DataSetを作成することができます。コネクターアカウントは、Data Centerの **［アカウント］** タブで管理できます。このタブの詳細については、「 [コネクター/アダプターアカウントを管理する](/ja/s/article/360042926054 "コネクター/アダプターアカウントを管理する") 」を参照してください。 ### ［詳細］ペイン このペインには、メインとなる **［Reports］** メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。

メニュー

説明

Query Type

クエリタイプを選択します。

Custom Query 実行するSQLクエリを入力します。
Query Builder クエリを自動生成する表とフィールドを選択します。

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］ を使用するには、以下を行います。

  1. 各メニューで、目的のウェアハウス、データベース、データベーススキーマ、データベーステーブル、テーブルの列を選択します。

  2. ［Query Helper］ フィールドに表示されるSQLステートメントをコピーします。

  3. コピーしたSQLステートメントを ［Query］ フィールドに貼り付けます。

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を追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。 ### よくある質問 このエラーを避けるには、トークンを更新する必要があります。Snowflakeでは、アカウントが期限切れになるたびに手動でDomoアカウントを再接続する必要があります。アカウントの有効期限は、Snowflake統合によってコントロールされています。90日ごとに更新トークンが期限切れになるように設定されている場合、90日ごとにアカウントを再接続する必要があります。更新のタイムアウトを91日以上にしたい場合は、Snowflakeサポートに連絡する必要があります。タイムアウトは90日から最大1年に延長することができます。 アカウントのフルネームと、クライアントの登録時にSnowflakeから提供されたクライアントIDおよびクライアントシークレットが必要です。自分の権限を入力することもできます。 制限は使用するサーバー構成によって異なります。 DataSetは15分間隔で実行できます。ただし、クエリの実行時間によっては、DataSetの実行頻度を低くする必要があります。 すべての単語、テーブル名、フィールド名が正しく記述されていることを確認してください。クエリのヘルプについては、［クエリヘルパー］フィールドを参照してください。 Snowflakeデータベースに接続する前に、接続するポート上のデータベースサーバーにある多数のIPアドレスをホワイトリストに登録する必要があります。IPアドレスの詳細なリストは、「 [ネットワーク接続にDomoのIPアドレスを許可する](/ja/s/article/360043630093) 」を参照してください。 Snowflake OAuth Internal Unload V2コネクターでは、パーティション分割がサポートされています。そのため、データをパーティション分割するかどうかを選択できます。また、日付形式またはクエリを使用して、データをパーティション分割するかどうかを選択することもできます。