Snowflake
まとめ
項目 | 説明 |
---|---|
リリース状態 | 一般提供 |
製品 | Power BI (セマンティック モデル) Power BI (データフロー) ファブリック (データフロー Gen2) Power Apps (データフロー) |
サポートされている認証の種類 | Snowflake (ユーザー名/パスワード)、Microsoft アカウント (Microsoft Entra ID) |
関数リファレンス ドキュメント | — |
Note
デプロイ スケジュールにより、またホスト固有の機能があることにより、ある製品に存在する機能が他の製品にはない場合があります。
サポートされる機能
- インポート
- DirectQuery (Power BI セマンティック モデル)
- 高度なオプション
- ロール名として使用するテキスト値を指定する
- リレーションシップ列
- 接続タイムアウト (秒)
- コマンド タイムアウト (秒)
- データベース
- ネイティブ SQL ステートメント
Power Query Desktop から Snowflake データウェアハウスに接続する
Snowflake コンピューティング ウェアハウスに接続するには、次の手順を行います。
Power BI Desktop の [ホーム] リボンから [データの取得] を選択し、左側のカテゴリから [データベース] を選択し、[Snowflake] を選択してから、[接続] を選択します。
表示される [Snowflake] ウィンドウで、[サーバー] に Snowflake サーバーの名前を入力し、[ウェアハウス] に Snowflake コンピューティング ウェアハウスの名前を入力します。
必要に応じて、接続クエリを変更するのに使用する詳細オプションに値 (ロール名やコマンド タイムアウトとして使用するテキスト値など) を入力します。 詳細情報: 詳細オプションを使用して接続
[OK] を選択します。
使用する Snowflake コンピューティング ウェアハウスにサインインするには、自分のユーザー名とパスワードを入力して、[接続] を選択します。
Note
特定の Snowflakeサーバーのユーザー名とパスワードを入力すると、Power BI Desktop はその後の接続試行で同じ資格情報を使用します。 これらの資格情報を変更するには、[ファイル] > [オプションと設定] > [データ ソース設定] に移動します。 詳細情報: 認証方法を変更する
Microsoft アカウント オプションを使う場合、Snowflake 側で Snowflake Microsoft Entra ID 統合を構成する必要があります。 詳細:Snowflake への Power BI SSO - はじめに
ナビゲーター で、Power BI Desktop にインポートして使用する 1 つまたは複数の要素を選択します。 次に、読み込みを選択して Power BI Desktop にテーブルを読み込むか、データの変換 を選択して Power Query エディターを開き、使用するデータ セットをフィルターして絞り込むことができます。 次に、その洗練されたデータ セットを Power BI Desktop に読み込みます。
[インポート] を選択して Power BI にデータを直接インポートするか、DirectQuery を選択してから OK を選択します。 詳細情報: Power BI Desktop で DirectQuery を使用する
Note
Microsoft Entra ID シングル サインオン (SSO) では、DirectQuery のみがサポートされます。
Power Query Online から Snowflake データベースに接続する
接続するには、次の手順を実行します。
コネクタの選択で [Snowflake] オプションを選択します。
表示される [Snowflake] ダイアログで、サーバーとウェアハウスの名前を入力します。
使用する詳細オプションに任意の値を入力します。 UI に表示されていない詳細オプションがある場合は、後で Power Query の [詳細エディター] で編集することができます。
新しい接続の選択または作成、使用するゲートウェイ、ユーザー名とパスワードなどの接続資格情報を入力します。
[次へ] を選択して、データベースに接続します。
[ナビゲーター] で、必要とするデータを選択してから、 [データの変換] を選択して、Power Query エディターでデータを変換します。
詳細オプションを使用して接続する
Power Query では、必要に応じてクエリに追加できる詳細オプションのセットが用意されています。
次の表に、Power Query で設定できるすべての詳細オプションを示します。
詳細オプション | 説明 |
---|---|
ロール名 | ドライバーを介してレポートで使用するロールを指定します。 このロールは、ユーザーが使用できるようにする必要があります。そうでない場合、ロールは設定されません。 |
リレーションシップ列を含める | オンにした場合は、他のテーブルとのリレーションシップがある列が含められます。 このボックスをオフにすると、それらの列は表示されません。 |
接続タイムアウト (秒) | Snowflake サービスとやりとりする場合に応答を待機する時間を指定します。この時間が経過すると、エラーが返されます。 既定値は 0 (タイムアウトなし) です。 |
コマンド タイムアウト (秒) | クエリが完了するまで待機する時間を指定します。この時間を経過すると、エラーが返されます。 既定値は 0 (タイムアウトなし) です。 |
データベース | ウェアハウス内の特定のデータベースを指定します。 このオプションは Power Query Desktop でのみ使用できます。 |
SQL ステートメント | 詳細については、「ネイティブ データベース クエリを使用してデータベースからデータをインポートする」を参照してください。 このオプションは Power Query Desktop でのみ使用できます。 |
必要とする詳細オプションを選択したら、Power Query デスクトップの [OK] または Power Query Online の [次へ] を選択して、Snowflake データベースに接続します。
トラブルシューティング
エラー: SQL コンパイル エラー: オブジェクトが存在しないか、操作を実行できません
このエラーは、指定されたオブジェクトがシステムで見つからない場合に発生します。 多くの場合、このエラーは、ユーザーが無効なデータベース名を既定のデータベースとして設定していることが原因です。
プロパティ DEFAULT_NAMESPACE に有効な既定のデータベース名が使用されていることを確認します: DESC USER
username
既定のデータベース名を更新するには: alter user
username
set DEFAULT_NAMESPACE=<database name>.<schema name>
。 詳細については、Snowflake ドキュメントの https://docs.snowflake.com/en/sql-reference/sql/alter-user を参照してください
制限事項と既知の問題
データベース名のハイフン
データベース名にハイフンが含まれている場合、ODBC: ERROR[42000] SQL compilation error
が表示されることがあります。 この問題は、2024 年 9 月のリリースで対処されています。
ブール データ型のスライサー ビジュアル
ブール データ型のスライサー ビジュアルは、2024 年 6 月のリリースで正常に機能していません。 これは既知の問題です。 一時的なソリューションとして、[転送] - [> データ型] - [> テキスト] に移動することで、ユーザーはレポートのブール データ型をテキストに変換できます。 修正プログラムは、2024 年 10 月のリリースで提供される予定です。