次の方法で共有


Microsoft Fabric の SQL データベースを Service Connector と統合する

このページでは、サポートされている認証方法とクライアントを示し、Service Connector を使用して Microsoft Fabric の SQL データベースにアプリを接続するために使用できるサンプル コードを示します。 このページには、サービス接続を作成するときに取得する既定の環境変数の名前と値も示されています。

サポートされているコンピューティング サービス

Service Connector を使用して、次のコンピューティング サービスを Fabric の SQL データベースに接続できます。

  • Azure App Service
  • Azure コンテナー アプリ
  • Azure Functions (アジュール ファンクションズ)
  • Azure Kubernetes Service (AKS)

サポートされている認証の種類とクライアントの種類

次の表は、Service Connector を使用して Fabric の SQL データベースにコンピューティング サービスを接続するためにサポートされる認証方法とクライアントの組み合わせを示しています。 "はい" は組み合わせがサポートされていることを示し、"いいえ" はサポートされていないことを示します。

クライアントの種類 システムによって割り当てられた管理ID ユーザーが割り当てた管理ID シークレット/接続文字列 サービス プリンシパル
。網 イエス イエス いいえ いいえ
行く イエス イエス いいえ いいえ
ジャワ イエス イエス いいえ いいえ
Java - スプリングブート イエス イエス いいえ いいえ
Python(プログラミング言語) イエス イエス いいえ いいえ
無し イエス イエス いいえ いいえ

この表は、Fabric の動作に従って、マネージド ID を介した認証のみが許可されることを示しています。

システム割り当てマネージド ID とユーザー割り当てマネージド ID メソッドは、.NET、Java、Java - Spring Boot、Python、Go、および None クライアントの種類でサポートされています。 これらのメソッドは、他の型ではサポートされていません。

重要

現在、完全なオンボードには手動アクセス共有が必要です。 「Fabric での SQL データベースへのアクセスの共有」を参照してください。

既定の環境変数名またはアプリケーション プロパティとサンプル コード

Fabric の SQL データベースにコンピューティング サービスを接続するには、次のタブに示されている接続の詳細とサンプル コードを参照してください。 名前付け規則の詳細については、「Service Connector の内部構造」を参照してください。

Fabric の SQL データベースは Azure SQL Database とは異なりますが、Azure SQL Database と同じ方法で Fabric の SQL データベースに接続してクエリを実行できます。 詳細については、こちらを参照してください

システムによって割り当てられた管理ID

既定の環境変数名 説明 値の例
FABRIC_SQL_CONNECTIONSTRING Azure SQL Database の接続文字列 Data Source=tcp:<Fabric-SQL-Identifier>.msit-database.fabric.microsoft.com,1433;Initial Catalog=<SQL-DB-name>-<Fabric-DB-Identifier>;Authentication=ActiveDirectoryManagedIdentity

サンプル コード

システム割り当てマネージド ID を使用して Fabric の SQL データベースに接続する手順とコード スニペットを次に示します。

  1. 依存関係をインストールします。

    dotnet add package Microsoft.Data.SqlClient
    
  2. Service Connector によって追加された環境変数から、Microsoft Fabric 接続文字列の SQL データベースを取得します。

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("FABRIC_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    詳細については、「 Active Directory マネージド ID 認証の使用」を参照してください。

詳細については、「 Microsoft Fabric で SQL データベースに接続する」を参照してください

ユーザー割り当てマネージド ID

既定の環境変数名 説明 値の例
FABRIC_SQL_CONNECTIONSTRING Azure SQL Database の接続文字列 Data Source=tcp:<Fabric-SQL-Identifier>.msit-database.fabric.microsoft.com,1433;Initial Catalog=<SQL-DB-name>-<Fabric-DB-Identifier>;User ID=<msiClientId>;Authentication=ActiveDirectoryManagedIdentity

サンプル コード

ユーザー割り当てマネージド ID を使用して Fabric の SQL データベースに接続する手順とコード スニペットを次に示します。

  1. 依存関係をインストールします。

    dotnet add package Microsoft.Data.SqlClient
    
  2. Service Connector によって追加された環境変数から、Microsoft Fabric 接続文字列の SQL データベースを取得します。

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("FABRIC_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    詳細については、「 Active Directory マネージド ID 認証の使用」を参照してください。

詳細については、「 Microsoft Fabric で SQL データベースに接続する」を参照してください

Fabric で SQL データベースへのアクセスを共有する

  1. Cloud Shell またはローカルの Azure CLI でサービス接続の作成を完了します。

  2. 接続が作成されたら、Azure portal でコンピューティング サービス リソースを開き、[Service Connector] メニューを開き、Fabric サービス接続で SQL データベースを見つけます。 SQL データベースを選択して Fabric ポータルに移動します。

    Azure portal のスクリーンショット。[SQL Database] リンクを選択して Fabric ポータルに移動します。

  3. Fabric ポータルで、[ セキュリティ ] タブを見つけて、[ SQL セキュリティの管理] を選択します。

    [SQL セキュリティの管理] を選択した Fabric ポータルのスクリーンショット。

  4. ロール db_ddladminを選択し、[ アクセスの管理] を選択します。

    Fabric ポータルのスクリーンショット。db_ddladmin ロールを選択し、[アクセスの管理] をクリックします。

  5. システム割り当てマネージド ID の名前、または Fabric のこの SQL データベースへのサービス接続を持つユーザー割り当てマネージド ID の名前が表示されます。 [ データベースの共有] を選択します。 [ データベースの共有 ] オプションが表示されない場合は、残りの手順を続行する必要はありません。

    Fabric ポータルのスクリーンショット。ロールに追加されたグループの一覧を表示し、[データベースの共有] をクリックします。

  6. [ アクセスの管理 ] ウィンドウに表示される、新しく作成したシステム割り当てマネージド ID の名前、またはユーザー割り当てマネージド ID の名前を入力して選択します。 必要に応じて、他の ID を追加します。 [ SQL データベースを使用してすべてのデータを読み取る ] チェック ボックスをオンにし、[ 許可] を選択します。

    ファブリック ポータルのスクリーンショット。割り当てられたマネージド ID の名前を入力し、[SQL データベースを使用してすべてのデータを読み取る] を選択し、[許可] をクリックします。

  7. これで、Fabric の SQL データベースへの新しいサービス接続を使用する準備ができました。

次のステップ

Service Connector の詳細については、次の記事を参照してください。