はじめに
Snowflakeは、すべてのデータを簡単にまとめて、分析する必要のあるすべてのユーザーとシステムが利用できるようにするData Warehouseです。DomoのSnowflakeコネクターを使用してSQLクエリを入力すると、指定したウェアハウス、データベース、およびデータベーススキーマからデータを取得できます。Snowflake APIの詳細については、https://docs.snowflake.net/manualsを参照してください。
Snowflakeコネクターは、クエリを使用してデータベースからデータを取得する「データベース」コネクターです。Data Centerでは、ウィンドウ上部のツールバーで［データベース］をクリックすることで、このデータベースコネクターや他のデータベースコネクターのコネクターページにアクセスできます。
このトピックでは、Snowflakeコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加、更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「データコネクターを使用してDataSetを追加する」を参照してください。
必要条件
Snowflakeデータベースに接続し、DataSetを作成するには、以下が必要です。
-
アカウントのフルネーム（Snowflakeにより提供）。これは、SnowflakeURLのhttps://の直後に続く部分です。
アカウントのフルネームはアカウントがホストされる地域とクラウドプラットフォームを識別する追加のセグメントが含まれる場合があることに注意してください。以下の表に、クラウドプラットフォームまたは地域別のアカウント名の例を示します。各行に対して、アカウント名が「xy12345」
であると仮定しています。 -
Snowflakeアカウントのユーザー名とパスワード。
Snowflakeアカウントに接続する
このセクションでは、［Snowflakeコネクター］ページの［認証情報］ペインと［詳細］ペインのオプションについて説明します。このページ内の他のペインに含まれるコンポーネントである［スケジュール設定］や［DataSetに名前を付け、説明を入力］に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「データコネクターを使用してDataSetを追加する」を参照してください。
認証情報ペイン
このペインには、Snowflakeアカウントに接続するための認証情報を入力するフィールドがあります。下表は、各フィールドに必要な内容を説明しています。
|
フィールド |
説明 |
|---|---|
|
アカウント名 |
Snowflakeアカウント名を入力します。アカウント名を検索する方法については、「必要条件」を参照してください。 |
|
ユーザー名 |
Snowflakeアカウントに関連するユーザー名を入力します。 |
|
パスワード |
Snowflakeアカウントに関連付けられたパスワードを入力します。 |
Snowflakeの有効な認証情報を入力すると、SnowflakeのDataSetを作成する際にいつでもDomoで同じアカウントを使用できます。コネクターのアカウントはData Centerの［アカウント］タブで管理できます。このタブの詳細については、「コネクターのユーザーアカウントを管理する」を参照してください。
詳細ペイン
このペインには、SQLクエリを入力したり、取得するデータの場所を指定する多数のフィールドとメニューがあります。
|
パラメーター |
説明 |
|---|---|
|
クエリ |
データを取得するために使用するSQLクエリを入力します。クエリヘルパーパラメーターを使用して、使用可能なSQLクエリを記述できます。クエリヘルパーを使用するには、以下を実行します。
|
|
ウェアハウス |
取得したいデータが格納されているウェアハウスを選択します。このリストには、認証情報にもとづいてアクセスできるすべてのウェアハウスが表示されます。 |
|
データベース |
取得したいデータが格納されているデータベースを選択します。このリストには、認証情報にもとづいてアクセスできるすべてのデータベースが表示されます。 |
|
データベーススキーマ |
取得したいデータが含まれているデータベーススキーマを選択します。このリストには、認証情報にもとづいてアクセスできるすべてのスキーマが表示されます。 |
|
データベース表（オプション） |
取得するデータベース表を選択します。このリストには、認証情報にもとづいてアクセスできるすべての表が表示されます。データベーステーブルを選択しない場合は、コネクターはデータベーススキーマ全体を取得します。 |
|
表の列（オプション） |
取得する表の列を選択します。このリストには、認証情報にもとづいてアクセスできるすべての列が表示されます。表の列を選択しないと、コネクターは選択したデータベース表全体を取得します。 |
|
クエリヘルパー（オプション） |
上のメニューから、ウェアハウス、データベース、スキーマ、表などを選択すると、利用可能なSQLクエリがこのフィールドに作成されます。このフィールドのSQLステートメントをコピーして、［クエリ］フィールドに貼り付けます。詳細については、上記の「クエリ」を参照してください。 |
| フェッチサイズ（オプション） | メモリのパフォーマンスのフェッチサイズを入力します。空白にすると、デフォルトサイズの1000が適用されます。DataSetに「メモリー不足」エラーが発生した場合は、フェッチサイズの縮小を試みます。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「データコネクターを使用してDataSetを追加する」を参照してください。
よくある質問
注意すべきAPI制限はありますか？
制限は使用するサーバー構成によって異なります。
データ更新の頻度はどのくらいですか？
DataSetは15分ごとに実行できます。ただし、クエリの実行時間によっては、DataSetの実行頻度が低くなる場合があります。
クエリの記述の際に注意すべき点はありますか？
すべての単語、テーブル名、フィールド名が正しく記述されていることを確認します。クエリのヘルプについては、［クエリヘルパー］フィールドを参照してください。
Snowflakeデータベースに接続できない理由は？IPアドレスのホワイトリスト登録が必要でしょうか？
Snowflakeデータベースに接続する前に、接続するポート上のデータベースサーバーにある多数のIPアドレスをホワイトリストに登録する必要があります。IPアドレスの詳細なリストは、「DomoでIPアドレスをホワイトリストに登録する」を参照してください。
これはプロダクションレベルのコネクターですか？
はい。このコネクターは、あらゆるサイズのDataSetを対象として設計されています。
ウェアハウス、データベース、スキーマなどのリストが正しく表示されない理由は？
Snowflakeでアカウントに入力されたユーザー権限にもとづいてアクセスできるコンテンツのみが表示されます。目的のものが見つからない場合は、権限がそのウェアハウス、データベース、テーブルなどにアクセスできることを確認してください。
Snowflakeで権限を入力しない場合、デフォルトではSYSADMIN権限が使用されます。
コメント
0件のコメント
サインインしてコメントを残してください。