FabricにおけるSQLデータベースのスキル

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

Important

この機能は プレビュー段階です。

Fabricのスキルは、AIコーディングアシスタントがFabricのワークロード、API、クエリパターン、運用のベストプラクティスを理解するのを助ける再利用可能な指示です。 SQLデータベーススキルは、エージェント型コマンドラインやコーディング環境からFabricのSQLデータベースを扱う際のタスク固有のガイダンスを提供します。

この記事では、Fabricスキルバンドルのインストール方法、アシスタントをFabric環境に接続する方法、そしてSQLデータベースの作成、利用、運用スキルの活用方法を紹介します。 スキルはアシスタントを導きます。あなたのアイデンティティ、権限、ツール、そしてFabricのセキュリティコントロールがすべての行動を支配しています。

前提条件

  • Fabricワークスペースにアクセスして、あなたが要求した操作を実行する権限。
  • GitHub Copilot CLI、Claude Code、Visual Studio Code、Cursor、Windsurf、その他の互換ツールなどの AGENTS.md ツール。
  • Node.js: npm パッケージ (npm install -g @github/copilot) としてインストールされるスタンドアロン GitHub Copilot CLI に必要です。 完全なセットアップ手順については、「GitHub Copilot CLI のセットアップ」を参照してください。
  • PowerShell 7: GitHub Copilot CLI に必要です。 pwsh --version で確認します。
  • Git: プラグイン マーケットプレースを使用しないツールのスキル リポジトリを複製するために必要です。
  • Azure CLI: ほとんどのFabric操作では、Azure認証が必要です。 インストール後、 az loginでサインインします。

Microsoft Fabricのスキルをインストールする

  1. GitHub Copilot CLIやClaude Codeを開いてください。 GitHub Copilot CLI と Claude Code はどちらも、同じプラグイン マーケットプレース ワークフローを使用します。

  2. GitHub Copilot CLIで公開マーケットプレイスを追加する:

    /plugin marketplace add microsoft/skills-for-fabric

  3. Fabric マーケットプレースのスキルを追加します。

    /plugin marketplace add microsoft/skills-for-fabric

    マーケットプレイスで利用可能なすべてのプラグインやスキルを見るには、以下を入力してください: /plugin marketplace browse fabric-collection。

  4. Fabric コレクションをインストールします。

    /plugin install fabric-skills@fabric-collection

    範囲を縮小するために、 fabric-operationsのようなフォーカスバンドルをインストールし、 sqldb-cli スキルを含みます。

    /plugin install fabric-operations@fabric-collection

  5. スキルを読み込むには、ツールを終了して再起動してください。

    /quit

  6. インストールを確認します。

    /skills

SQLデータベースのスキル

以下のスキルはFabricのSQLデータベースに関連しています。

Skill これを次の目的に使用します。 意図の例
sqldb-authoring-cli データベースオブジェクトやデータの作成と変更。 テーブルの作成、行の読み込み、インデックスの追加、またはストアドプロシージャの展開などです。
sqldb-consumption-cli スキーマの発見と読み取り専用クエリの実行。 テーブルのリスト作成、列の検査、最近の注文の要約、結果セットの説明などが可能です。
sqldb-operations-cli 健康、パフォーマンス、運用上の問題を調査すること。 遅いクエリを分析し、ブロッキングを特定し、データベースリソースの使用状況を確認しましょう。

すべてのFabricワークロードで利用可能なスキルの全カタログについては、GitHub: Skills for Fabricをご覧ください。

FabricでSQLデータベースを使ったスキルの使い方

  1. プロジェクトや作業フォルダ内のターミナルを開いてください。

  2. 「 Copilot 」と入力し、[ Enter] を選択します。

    WindowsのPowerShell端末のスクリーンショットです。

    GitHub Copilotがローンチされました。

    PowerShell端末でGitHub Copilotインターフェースが表示されているスクリーンショットです。

  3. ターゲットFabricワークスペースにアクセスできるMicrosoftアイデンティティで認証するには、「az login」と入力し、手順に従ってください。

SQLデータベースを開発する

タスクがデータベースの状態を変えるときに sqldb-authoring-cli スキルを使いましょう。 GitHub Copilotでデータベースオブジェクトを作成または更新するには、必ずターゲットのワークスペース、データベース、環境、オブジェクト、期待されるスキーマ、制約、そしてアシスタントがスクリプトのみを生成するかレビュー後に実行するかを含めてください。 スキーマの変更やデータの変更については、エラー処理やトランザクションのロールバックを行うための TRY...CATCH を依頼できます。

Tip

読み取り専用の要求でT-SQL文を生成し、実行前に生成されたT-SQL文を確認します。

例えば、これらのサンプルプロンプトを使ってサンプルデータを含むテーブルを作成・読み込むことができます。

In the Sales SQL database, create a dbo.CustomerFeedback table with an identity key, 
customer ID, feedback text, sentiment, created date, and a foreign key to 
dbo.Customer.CustomerID. All columns should be nullable. The create date should 
be populated by a default. Generate the T-SQL for review; don't execute it. 

Generate 100 sample data rows for the dbo.CustomerFeedback as a single 
INSERT statement, referencing rows in the dbo.Customer table. 
Generate a TRY...CATCH structure to handle any errors and rollback. 
Do not execute the script, let me review.

データの探索とクエリ

sqldb-consumption-cli スキルを、読み取り専用での探索と分析に使用してください。 まずアシスタントにメタデータを確認し、オブジェクト名を補足し、結果サイズを制限し、仮定を説明してもらいます。

例えば、Copilotを使ってメタデータやテーブルデータをクエリします:

List the user tables and views in the Sales SQL database and describe their relationships. 
Don't modify any objects.

Find the top 10 products by revenue in the last 30 days. 
Show the T-SQL and summarize the result.

Inspect the available columns before answering: 
Which customers have not placed an order in the last 90 days?

データベース操作の調査

sqldb-operations-cliスキルを使ってパフォーマンスと信頼性を調査しましょう。 時間枠、観察された症状、影響を受けた業務量、アシスタントが診断データを収集できるかどうかを記載してください。

例えば、以下のクエリは現在または過去のパフォーマンス問題を調査したり、クエリのパフォーマンスを調整したりします。

Investigate why the nightly order-processing query slowed down between 01:00 and 02:00 UTC. 
Start with read-only diagnostics and rank the likely causes.

Check for blocking sessions and long-running requests. 
Explain the evidence before recommending a mitigation.

Review this execution plan and suggest indexes only when the expected benefit and write overhead are clear.

T-SQLクエリをレビューし実行するためのチェックリスト

  1. アシスタントが意図したSQLデータベーススキルを選択したことを確認しましょう。
  2. ワークスペース名、データベース、スキーマ名、オブジェクト名を確認してください。
  3. 破壊操作、トランザクションの動作、データ範囲について生成されたT-SQLをレビューしてください。
  4. 変更を書く前に、影響の要約とロールバックのアプローチを求めてください。 スキーマの変更については、ロールバックやT-SQLスクリプトの元に戻す準備をしてください。
  5. 計画が自分の意図に合った後にのみ実行してください。
  6. 結果を別の読み取り専用クエリで検証します。

セキュリティと責任ある使用

  • これらのスキルはMicrosoft Entra認証、Fabric権限、SQL権限、組織ポリシーを迂回しません。
  • 常に最も低い特権IDを使用し、開発、テスト、本番のターゲットを分けてください。
  • プロンプトやプロジェクトファイルに秘密情報、アクセストークン、機密データを置かないでください。
  • 生成されたSQLを提案コードとして扱いましょう。 他のデータベース変更と同じように見直してください。
  • 変更や是正を行う前に、まず読み取り専用の検出を優先してください。

詳細については、「FabricにおけるCopilotのプライバシー、セキュリティ、そして責任あるAIの利用」をご覧ください。

関連するコンテンツ

  • Last updated on