適用対象:✅ Microsoft Fabric の SQL 分析エンドポイントおよびウェアハウス
Microsoft Fabric では、ユーザーは表形式データ ストリーム (TDS) エンドポイントを介して SQL 分析エンドポイントまたは Warehouse にアクセスします。 最新の Web アプリケーションは、A SQL Server TDS エンドポイントと対話します。 Microsoft Fabric の設定内では、このエンドポイントには SQL 接続文字列としてラベルが付けられます。
ヒント
一般的なツールとの接続に関するチュートリアルについては、「 Fabric Data Warehouse への接続」を参照してください。
Fabric の倉庫への認証
Microsoft Fabric では、SQL 接続文字列は次の 2 種類の認証済みユーザーをサポートしています。
- Microsoft Entra ID のユーザー プリンシパル、またはユーザー ID
- Microsoft Entra ID サービス プリンシパル
詳細については、「Microsoft Fabric の SQL 認証の代替え手段とする Microsoft Entra 認証」を参照してください。
SQL 接続文字列では、TCP ポート 1433 が開かれている必要があります。 TCP 1433 は、標準の SQL Server ポート番号です。 SQL 接続文字列は、ウェアハウスまたはレイクハウス SQL 分析エンドポイントのデータ アクセスのセキュリティ モデルも考慮します。 ユーザーは、アクセス許可を持つすべてのオブジェクトのデータにアクセスできます。
SQL 分析エンドポイントのセキュリティの詳細については、SQL 分析エンドポイント の OneLake セキュリティに関するページを参照してください。
ベスト プラクティス
アプリケーションと ETL ジョブに再試行を追加して、回復性を高めます。 詳しくは、次のドキュメントをご覧ください。
- 再試行パターン - Azure アーキテクチャ センター
- 一時的なエラーへの対応 - Azure SQL Database
- 手順 4: ADO.NET で SQL に弾性的に接続する - ADO.NET Provider for SQL Server
- 手順 4: PHP を使用して SQL に弾性的に接続する - SQL Server 用 PHP ドライバー
- 次のセクションで説明するように、ファイアウォールのクリアランスにはサービス タグを使用します。
- 接続するときは、最初の カタログ または データベース名 として倉庫アイテム名を指定する必要があります。
InitialCatalog接続文字列プロパティを指定しない場合、初期接続コンテキストはmasterウェアハウスになります。
ファイアウォール経由で Azure サービス タグを許可する
ファイアウォール経由の接続を有効にするには、Power BI サービス タグと SQL サービス タグを許可する必要があります。 詳細については、「 Power BI サービス タグ と サービス タグ」を参照してください。
TDS エンドポイントの完全修飾ドメイン名 (FQDN) のみを使用することはできません。
考慮事項と制限事項
- SQL 認証はサポートされていません。
- Microsoft Fabric Warehouse では、複数のアクティブな結果セット (MARS) はサポートされていません。 MARS は既定で無効になっています。 接続文字列に
MultipleActiveResultSetsが含まれている場合は、削除するか、false に設定します。 - エラー コード 24804 と「システムの更新が原因で操作を完了できませんでした。 この接続を閉じて、再度サインインし、操作を再試行してください」またはエラー コード 6005 と「シャットダウンが進行中です」というメッセージが表示されます。 Execution fail against sql server. (SQL Server に対する実行が失敗します。) さらにサポートが必要な場合は、SQL Server チームにお問い合わせください」というメッセージが表示される場合、これは一時的な接続の損失が原因であり、システムの展開または再構成によるものと考えられます。 この問題を解決するには、もう一度サインインして再試行してください。 アプリケーションで回復性と再試行を構築する方法については、「ベスト プラクティス」を参照してください。
- SQL Server からのリンク サーバー接続はサポートされていません。
InitialCatalog の接続動作
2026 年 5 月に、Microsoft は Fabric Data Warehouse と SQL analytics エンドポイントの接続動作を更新し、InitialCatalog 接続文字列プロパティを省略可能にしました。 現在、master プロパティが指定されていない場合、ユーザーは InitialCatalog システム データベースに接続します。 Fabric Data Warehouseでは、master データベースにのみ接続でき、master データベースは変更できません。また、master データベースにユーザー オブジェクトを作成、変更、または削除することもできません。
USE Transact-SQL 構文を使用して、master に接続したら接続ウェアハウス コンテキストを変更し、DB_NAME() 関数を使用して現在のウェアハウスを決定できます。 例えば次が挙げられます。
SELECT DB_NAME(); --returns name of current warehouse context
GO
USE [ContosoWarehouse];
GO
SELECT DB_NAME(); --returns name of current warehouse context
GO
次の表は、接続文字列で InitialCatalog プロパティを指定または省略した場合の、Fabric Data Warehouseおよび SQL 分析エンドポイントの更新された接続動作の概要を示しています。
| 入力シナリオ | 2026 年 5 月より前 | 現在の動作 |
|---|---|---|
| 指定された既存の倉庫名 | 指定したウェアハウスに接続します | 変更なし - 指定されたウェアハウスに接続します |
| 既存の倉庫 ID が指定されています | 指定したウェアハウスに接続します | 変更なし - 指定されたウェアハウスに接続します |
InitialCatalog プロパティが指定されていません |
ワークスペース内の非決定論的なウェアハウスに接続します。 |
master に接続 |
InitialCatalog = master |
ワークスペース内の非決定論的なウェアハウスに接続します。 |
master に接続 |
InitialCatalog プロパティ内のウェアハウスが存在しない |
ワークスペース内の非決定的なウェアハウスに接続します。 | ウェアハウスが存在しないことを示すエラーをスローします |
エラー処理
ワークスペースにウェアハウスが存在せず、有効なウェアハウスを指定せずに接続が試行された場合、ユーザーには次のエラーが表示されます: "ユーザー '<トークンで識別されたプリンシパル>' のログインに失敗しました。 理由: 認証は成功しましたが、データベースが見つかりませんでした。または、データベースに接続するためのアクセス許可が不十分です。
次のスクリーンショットは、無効なウェアハウス名が InitialCatalogとして指定されている場合に SSMS に表示されるエラーを示しています。
