Snowflake Managed Unloadコネクター

**注記：**Snowflakeは2025年11月以降、ユーザー名とパスワードによる認証メカニズムのサポートを終了します。そのため、このConnectorの提供を段階的に終了します。代わりに、以下のいずれかの接続方法の利用をご検討ください。

• Cloud Amplifier
• Snowflake Key Pair Internal Managed Unloadコネクター
• Snowflake OAuth Internal Unload v2コネクター

​

はじめに

Snowflakeは、クラウドベースのアナリティクスデータウェアハウスシステムです。DomoのSnowflake Managed Unloadコネクターを使用すると、データをSnowflakeデータベースからAmazon S3の内部にアンロードできます。その後、ファイルは社内のS3からDomoにダウンロードされます。非常に大きなクエリを実行している場合は、このコネクターがほかのSnowflakeコネクターよりも優先されます。Snowflake APIの詳細については、Snowflakeのウェブサイト（https://docs.snowflake.com/ja）を参照してください。

Snowflake Managed Unloadアカウントには、Data Centerから接続します。このトピックでは、Snowflake Managed Unloadコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「コネクターを使用してDataSetを追加する」を参照してください。

​

必要条件

Snowflake Managed Unloadアカウントに接続し、DataSetを作成するには、以下が必要です。

• アカウントのフルネーム（Snowflakeが提供）。米国西部地域はaccount_name、その他の地域はaccount_name.region_idです。これは、Snowflake URLのhttps://の直後に続く部分です。

  アカウントのフルネームには、アカウントがホストされる地域とクラウドプラットフォームを識別する追加のセグメントが含まれる場合があることに注意してください。以下の表に、クラウドプラットフォームまたは地域別のアカウント名の例を示します。各行では、アカウント名が「xy12345」であると仮定しています。

• Snowflakeホストへの接続に使用するユーザー名とパスワード。

Snowflake Managed Unloadコネクターでは、通常のSnowflakeコネクターよりも多くの権限が必要になります。権限に関するコマンドのリストを次に示します。

CREATE STAGE	新しいステージを作成し、テーブルからファイルにデータをアンロードします。
COPY INTO <場所>	テーブルのすべての行を、1つ以上のファイルにアンロードしてステージに移動するようコマンドします。
CREATE FILE FORMAT	ファイルフォーマットを作成します。
LIST	ステージングされたファイルのリストを返します。
GET	上記で作成されたSnowflakeステージからデータファイルをダウンロードします。
REMOVE	ステージングされ、テーブルからアンロードされたファイルを削除します。

​

Snowflake Managed Unloadアカウントに接続する

このセクションでは、Snowflake Managed Unloadコネクターページの**［認証情報］ペインと［詳細］ペインのオプションについて説明します。このページのほかのペインの項目である［スケジュール設定］や［DataSetに名前を付け、説明を入力］**に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「コネクターを使用してDataSetを追加する」を参照してください。

​

［認証情報］ペイン

このペインには、Snowflake Managed Unloadアカウントに接続するための認証情報を入力するフィールドがあります。以下の表は、各フィールドに必要な内容を説明しています。

フィールド	説明
Account Name	Snowflakeアカウント名を入力します。詳細については、「必要条件」を参照してください。
Username	Snowflakeホストへの接続に使用するユーザー名を入力します。
Password	Snowflakeホストへの接続に使用するパスワードを入力します。
Role	権限を入力します。

有効なSnowflake Managed Unload認証情報を一度入力しておくと、いつでも同じアカウントを使用して、新しいSnowflake Managed Unload DataSetを作成することができます。コネクターアカウントは、Data Centerの**［アカウント］**タブで管理できます。このタブの詳細については、「コネクター/アダプターアカウントを管理する」を参照してください。

​

［詳細］ペイン

このペインには、メインとなる**［Reports］**メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。

メニュー	説明
Report	クエリタイプを選択します。以下のクエリタイプを利用できます。 Custom Query 実行するSQLクエリを入力します。 Query Builder クエリを自動生成するテーブルとフィールドを選択します。
Query	データを取得するSQLクエリを入力します。クエリヘルパーパラメーターを使用して、使用可能なSQLクエリを記述できます。クエリヘルパーを使用するには、以下を行います。 1. 各メニューで、目的のウェアハウス、データベーススキーマ、データベースオブジェクト、およびテーブルの列またはビューを選択します。 2. ****［Query Helper］フィールドに表示されるSQLステートメントをコピーします。 3. コピーしたSQLステートメントを［Query］****フィールドに貼り付けます。
Warehouses	取得したいデータが格納されているウェアハウスを選択します。このリストには、認証情報にもとづいてアクセス権のあるすべてのウェアハウスが表示されます。
Databases	取得したいデータが格納されているデータベースを選択します。このリストには、認証情報にもとづいてアクセス権のあるすべてのデータベースが表示されます。
Database Schemas	取得したいデータが格納されているデータベーススキーマを選択します。このリストには、認証情報にもとづいてアクセス権のあるすべてのスキーマが表示されます。
Database Objects	取得したいデータが格納されているデータベースオブジェクトを選択します。このリストには、認証情報にもとづいてアクセス権のあるすべてのオブジェクトが表示されます。
Database Views	取得したいデータベースビューを選択します。このリストには、認証情報にもとづいてアクセス権のあるすべてのビューが表示されます。データベースビューを選択しない場合は、コネクターはデータベーススキーマ全体を取得します。
Database Tables	取得したいデータベーステーブルを選択します。このリストには、認証情報にもとづいてアクセス権のあるすべてのテーブルが表示されます。データベーステーブルを選択しない場合は、コネクターはデータベーススキーマ全体を取得します。
Table Columns	取得したいテーブルの列を選択します。このリストには、認証情報にもとづいてアクセス権のあるすべての列が表示されます。テーブルの列を選択しないと、コネクターは選択したデータベーステーブル全体を取得します。
Query Helper	上部のメニューから、ウェアハウス、データベース、スキーマ、テーブルなどを選択すると、利用可能なSQLクエリがこのフィールドに作成されます。このフィールドのSQLステートメントをコピーして、****［Query］****フィールドに貼り付けます。詳細は、上記の「Query」を参照してください。
Partition Support	データをパーティション分割するかどうかを選択します。
Past Days	データを取得する過去の日数を入力します。値はXとすることができ、この場合Xは正の整数です。例：30。
Date Format	必要な日付形式を選択します。デフォルトでは、yyyy-MM-ddが使用されます。
Custom Date Format	カスタマイズされた日付形式を入力します。
Query Tag	SnowflakeでConnector SQLの実行にクエリタグとしてタグ付けするために使用できるオプションのパラメーターです。

​

その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「コネクターを使用してDataSetを追加する」を参照してください。

​

よくある質問

このコネクターはいつ使用しますか？

Snowflake KeyPair Internal Managed Unloadコネクターは、ユーザーが定義したS3バケットにデータをアンロードしてからDomoにデータを取り込むことで、SnowflakeからDomoにデータをインポートします。このコネクターはあらゆるサイズのDataSetに適しており、非常に大きなDataSetで推奨されます。接続するには、Snowflakeのローカルのユーザー名とシークレットキーが必要です。

注意すべきAPI制限はありますか？

制限は使用するサーバー構成によって異なります。

データはどれくらいの頻度で更新されますか？

DataSetは15分ごとに実行できます。ただし、クエリの実行時間によっては、DataSetの実行頻度が低くなる場合があります。

クエリの記述の際に注意すべき点はありますか？

すべての単語、テーブル名、フィールド名が正しく記述されていることを確認します。クエリのヘルプについては、［Query Helper］フィールドを参照してください。

Snowflakeデータベースに接続できない理由は何ですか？IPアドレスをホワイトリストに登録する必要がありますか？

Snowflakeデータベースに接続する前に、接続するポート上のデータベースサーバーにあるいくつかのIPアドレスをホワイトリストに登録する必要があります。IPアドレスの詳細なリストは、「DomoでIPアドレスをホワイトリストに登録する」を参照してください。