次の方法で共有

Microsoft Fabricで SQL データベースに接続する

対象:✅Microsoft Fabric の SQL データベース

Azure SQL Database と同じ方法で、Fabric の SQL データベースに接続してクエリを実行できます。

Prerequisites

Fabric ポータルのクエリ エディター

Fabric ポータルの Web ベース エディターを使用して SQL データベースに接続できます。

Fabric SQL データベース用の Web ベース エディターは、基本的なオブジェクト エクスプローラーとクエリ実行インターフェイスを備えています。 統合された [エクスプローラー] メニューには、すべてのデータベース オブジェクトが一覧表示されます。

Fabric の新しい SQL データベースが Web エディターに自動的に開き、既存のデータベースを Fabric で選択して Web エディターで開くことができます。

SQL接続文字列を検索する

Microsoft Fabricでは、SQL 分析エンドポイントと SQL データベースには、表形式のデータ ストリーム(TDS エンドポイント)を介してアクセスできます。これは、a SQL Server TDS エンドポイントと対話するすべての最新の Web アプリケーションになじみがあります。 これは、Microsoft Fabric ユーザー インターフェイス内の SQL connection stringと呼ばれます。

  • SQL データベースのサーバー名は、Azure SQL Databaseのサーバー名 (<server-unique-identifier>.database.windows.net) に似ています。
  • SQL 分析エンドポイント サーバー名は、ウェアハウスのサーバー名 ( <server-unique-identifier>.<tenant>.fabric.microsoft.com) に似ています。

Fabric SQL データベースのサーバー名を検索するには:

  • SQL データベース項目の設定に移動します。
  • または、項目の一覧で、 ... メニューを選択します。 [設定] を選択し、次に [接続文字列] を選択します。 Fabric は、ADO、.NET、JDBC、ODBC、PHP、Go などのプロバイダー向けの完全な接続文字列を提供します。
  • または、Open in ボタンを選択し、SQL Server Management Studio または Visual Studio Code を選択します。 サーバー名とデータベース名が表示されます。

SQL データベースの SQL 分析エンドポイント のサーバー名を検索するには:

  • SQL データベース項目の設定に移動し、[接続文字列] を選択 します。
  • または、... メニューを選択し、SQL エンドポイントを選択し、SQL connection string をコピーします。 これはサーバー名です。

[次の方法で開く] ボタンで接続する

Fabric ポータルのクエリ エディターの [次の方法で開く] ボタンを使用して、SQL データベースに簡単に接続できます。 SQL Server Management StudioまたはVisual Studio Code。

VS Code で SSMS または MSSQL 拡張機能と簡単に接続するための [開く] ボタンを示す Fabric ポータル クエリ エディターのスクリーンショット。

SQL Server Management Studioを手動で接続する

SSMS のバージョンが 21 より前の場合、[開く] をクリックしても接続の詳細が自動的に入力されることはサポートされませんが、サーバー、データベース、認証情報を手動で指定することで引き続き接続できます。

SSMS 設定のスクリーンショット。

SQL Server Management Studio (SSMS):

  1. Fabric の [データベース] ワークロードのワークスペース領域から、SQL データベースの横にある ... を選択します。
  2. 設定を選択します。
  3. [接続文字列] を選択します。 SQL データベースへの接続文字列（を含む）を探します。 たとえば、「 tcp:<servername>.database.fabric.microsoft.com,1433 」のように入力します。 Initial Catalog= はデータベース名です。
  4. SSMS で、[新しい接続] を開きます。
  5. [ファブリック] ダイアログ ボックスで、 Server Name の値をコピーして サーバー名に貼り付けます。
  6. Authentication の種類: Microsoft Entra ID - MFA サポートを使用するユニバーサルを選択します。
  7. オプション<<を選択します。
  8. Database Name の値をコピーして、[データベースに接続] テキスト ボックスに貼り付けます。
  9. 接続を選択します。
  10. MFA対応のMicrosoft Entra ID - Universalを使用してサインインします。

Visual Studio Code用の MSSQL 拡張機能を手動で接続する

VS Code の MSSQL 拡張機能で Fabric 参照エクスペリエンスを使用することもできます。 この機能を使用すると、開発者は Fabric ポータルから接続文字列を手動でコピーしたり、[ 開く ] ボタンを使用して VS Code 内のデータベースに直接接続したりすることなく、Fabric または SQL 分析エンドポイントの SQL データベースにシームレスに接続できます。

VS Code の接続設定のスクリーンショット。

sqlcmd を使用して接続する

他の SQL Database Engine製品と同様に、sqlcmd を使用して Fabric の SQL データベースに接続できます。 Gを使用します。 Microsoft Entra認証 (-G) には、少なくともバージョン 13.1 が必要です。

次の例では、<server name> を、Fabric SQL データベースを表す一意のテキストの長い文字列に置き換えます。

sqlcmd -S <your_server>.database.fabric.microsoft.com;1433 -G -d <your_database> -i ./script.sql

bcp ユーティリティを使用して接続する

他の SQL Database Engine 製品と同様に、bcp ユーティリティを使用して、Fabric の SQL データベースに接続できます。 -G オプションでMicrosoft Entra ID認証を使用します。

次の例では、<server name> を、Fabric SQL データベースを表す一意のテキストの長い文字列に置き換えます。

bcp bcptest in "c:\temp\sample.dat" -S <your_server>.database.fabric.microsoft.com;1433 -d testdb -G -c

Python Notebook を使用して接続する

Fabric Python Notebooks (プレビュー) ではT-SQL マジック コマンドを使用して T-SQL コードを実行できます。

ヒント

また、Microsoft Python Driver> を使用して、アプリケーションを Fabric の SQL データベースに<接続することもできます。

次の手順では、 %%tsql マジック コマンドを使用して Fabric の SQL データベースに接続します。

  1. 言語が Python に設定されたノートブックをワークスペースに作成します。

  2. セルで、 %%tsql マジック コマンドを使用します。 セルの種類が自動的に T-SQLに変わります。

    次の例では、 <databasename> を Fabric の SQL データベースの名前に置き換えます。 -type パラメーターはSQLDatabaseする必要があります。

    %%tsql -artifact <databasename> -type SQLDatabase

    次に、T-SQL コマンドを含めます。 たとえば、 Contoso という名前のデータベースからクエリを実行するには、次のようにします。

    %%tsql -artifact Contoso -type SQLDatabase
SELECT * FROM SalesLT.Customer;

  3. -bind引数を使用して、結果をデータフレームにバインドすることもできます。

    %%tsql -artifact Contoso -type SQLDatabase -bind df2

Python Notebook 内の T-SQL を使用してデータにクエリを実行する可能性の詳細については、「 Fabric Python ノートブックで T-SQL コードを実行するを参照してください。 完全な構文を表示するには、 %tsql? コマンドを使用します。 このコマンドは、使用可能なパラメーターとその説明など、T-SQL マジック コマンドのヘルプ情報を表示します。

関連コンテンツ

  • Last updated on