SQL Server Management Studio (SSMS) のCopilotには、自然言語でCopilotと対話するためのチャット ウィンドウが含まれています。 Copilot に SQL に関する一般的な質問をしたり、データベースに固有の質問をしたり、T-SQL の作成や編集のサポートを受けたりすることができます。
チャット ウィンドウ内で、送信するプロンプトのコンテキストを決定します。 コンテキストには、開いているクエリ エディター ウィンドウに基づいて、一般的なCopilotまたは特定のデータベースを指定できます。 データベースのコンテキスト内では、SSMS のCopilotにはコンテキスト (SQL バージョン) とデータベース (スキーマ対応) の両方に関する知識があるため、応答は環境に合わせて調整されます。
注
SSMS のCopilotからのクエリは、ユーザーのログインとアクセス許可のコンテキストで実行されます。 SSMS のCopilotに対する個別のアクセス許可はありません。
概要
Copilotを構成したら、次を使用してチャット ウィンドウを開きます。
- View>Copilot
- CtrlAltC
- ツール バーの Copilot ボタン
チャット ウィンドウは、SSMS 内の任意の場所にドッキングできる、オブジェクト エクスプローラーなどのツール ウィンドウです。 ツール ウィンドウでCopilotを移動するには、タイトル バーを選択し、別の場所にドラッグします。
SSMS ツール ウィンドウのCopilot内のテキストのサイズを増減するには、Ctrl + マウス ホイールを使用します。
コンテキストの変更
最初にクエリ エディター ウィンドウが接続されていない SSMS でCopilotを開く場合、Copilotはどのデータベースにも接続されていませんが、SQL または SSMS に関する一般的な質問をすることができます。 このシナリオでは、現在のコンテキストは SSMS の中の Copilot です。
特定のデータベースに対してクエリを実行したり、自然言語から SQL (NL2SQL) に関するヘルプを取得したり、その他のサポートを受けたりするには、そのデータベースに接続されているクエリ エディター ウィンドウを開きます。 チャット ウィンドウは、新しいクエリ エディターのコンテキストに自動的に変更されます。 コンテキストには、クエリ エディターの名前と接続情報が含まれます。
Copilotのコンテキストを変更するには、プロンプト ボックスに @ 記号を入力して、使用可能なコンテキスト リストを表示します。 コンテキストが変更されると、エディターと接続がプロンプト ボックスの上に現在のコンテキストとして一覧表示され、[ アクティブ エディターの同期 ] オプションは選択されません。
アクティブなエディターといつでも再同期するには、[アクティブ エディターの 同期 ] オプションを有効にします。
| 鍵 | 説明 |
|---|---|
| 1 | タイトル バー |
| 2 | Copilotウィンドウをピン留めまたは閉じるためのツールウィンドウコントロール |
| 3 | チャットの履歴をエクスポートまたはクリアするためのチャット オプション |
| 4 | Copilot応答コンテキスト |
| 5 | 送信されたプロンプト |
| 6 | フィードバック アイコン |
| 7 | クエリを含むCopilot応答 |
| 8 | 現在のコンテキスト |
| 9 | [アクティブ エディターの同期] オプション |
| 10 | 現在のモード |
| 11 | プロンプト ボックス |
| 12 | 状態情報 |
| 13 | プロンプトの履歴を表示し、プロンプトを送信するためのプロンプト オプション |
プロンプトを送信する
プロンプト ボックスにプロンプトを入力し、矢印アイコン (送信) または Enter キーを押して送信します。 送信されたプロンプトがチャット ウィンドウに表示されます。 Thinking...メッセージはCopilot応答を待機している間に表示されます。 応答はプロンプトの下に戻り、応答コンテキストは上部に表示され、会話を追跡するのに役立ちます。
NL2SQL プロンプトの場合、Copilotはデータベースメタデータに対してクエリを実行し、データベース内のオブジェクトに関するコンテキストを提供します。
別のクエリ エディター ウィンドウを開くと、Copilotに、その接続に変更する方法を示すメッセージが表示されます。 コンテキストが新しく開かれたウィンドウに自動的に変更されることはありません。
前のプロンプトを表示する
Copilotは、最近の履歴アイコン (Show Recent Questions) から選択できる最新のプロンプトを追跡します。 使用可能な一覧から任意のプロンプトを選択してもう一度送信するか、編集して送信します。
Transact-SQLをコピーしてクエリ エディターに挿入する
Copilotからの応答には、応答内に表示される T-SQL ステートメントを含めることができます。これには、Copy および Insert ボタンが含まれます。 コピーを使用して T-SQL をクリップボードにコピーし、挿入を使用して T-SQL をクエリ エディターに直接挿入します。 カーソル位置に基づいて挿入が行われます。
チャット履歴をクリアする
チャット履歴をリセットまたはクリアするには、ほうきアイコン (チャット履歴のクリア) を使用します。 このアクションにより、チャット履歴から既存のすべてのプロンプトと応答が消去され、取得できません。 チャットの以前の情報が失われ、エディターのCopilotを初めて開いたかのようにチャットを開始します。
チャット履歴を保存する
エクスポート アイコン (エクスポート) を使用してチャット履歴を保存できます。 [ 名前を付けて保存] ダイアログで、ファイルを保存する場所を参照します。 必要に応じて ファイル名 を編集し、[ 保存] を選択してチャットを Markdown ファイルとして保存します。
マークダウン ファイルは SSMS 21 で開き、Markdown ビューアーを使用して Markdown 形式でレンダリングできます。 ビューアーを呼び出すには、[プレビュー] ボタンまたは ShiftF7 を使用します。
データベース コンテキストの変更
Copilotには、クエリ エディターで接続しているデータベースに関するコンテキストがあります。 同じエディター ウィンドウで別のデータベースに接続する場合は、データベースのドロップダウン リストを使用するか、T-SQL ( など) を使用します。 データベース コンテキストを初めて変更すると、接続が変更されたことを示すメッセージがチャットに記録されます。 データベース コンテキストが変更されるたびに、プロンプト ボックスの上にある現在のコンテキストが更新されます。
モードを変更する
Copilotでは、クエリ実行の複数のモードがサポートされています。これは、適切なコマンドを使用してプロンプト ボックスで変更できます。 既定のモードは 読み取り専用です。
| Mode | コマンド | 説明 |
|---|---|---|
| [読み取り専用] | /ro |
データを読み取るクエリのみが実行されます。 |
| 読み取り/書き込み (承認あり) | /rwa |
データを読み取るクエリが実行され、書き込み (データまたはスキーマを変更する) クエリはユーザーの承認後に実行されます。 |
| 読み取り/書き込み | /rw |
データを読み取るクエリが実行され、書き込み (データまたはスキーマを変更する) クエリが自動的に実行されます (承認は必要ありません)。 |
使用中のモードの場合、Copilotには、ユーザーが実行できるステートメントを実行するアクセス許可のみが付与されます。 たとえば、 テーブルからデータを削除する権限がない場合があります。
DELETE * FROM Sales.Orders などのデータを削除するステートメントをCopilotに記述するように要求すると、Copilotがクエリを実行しようとすると失敗します。
Copilotの既定のモードを
その他のコマンド
Copilotには、エクスペリエンスのカスタマイズ、情報のキャプチャ、スループットの調整を行うコマンドが用意されています。
| 名前 | コマンド | 説明 |
|---|---|---|
| 様式 | /style: |
データを読み取るクエリのみが実行されます。 |
| ログ | /log |
出力ウィンドウの情報を、 内のファイルに直接保存します。 出力ウィンドウは 、ViewOutput を使用して表示できます。 |
| 最大結果トークンの設定 | /mrt: |
Copilotによって発行された T-SQL クエリからモデルに送り返すことができるトークンの最大数を設定します。 既定値は 75,000 トークンです。 トークンのサイズがクエリによって返されるデータよりも小さい場合、モデルは、"データベース内のすべてのオブジェクトの一覧が大きすぎて 1 つのクエリで処理できません" などの制限を示すように応答を調整します。 |
| 1 分あたりの最大トークン数を設定する | /tpm: |
Copilotによってモデルに送信できる 1 分あたりのトークンの最大数を設定します。 これは、1 分あたりのエンドポイント トークン (TPM) 容量を超えて、モデルに送信するデータの量が多くなりすぎないように調整できます。 |
コロン () を含むコマンドには、詳細が必要です。 たとえば、プロンプト を送信してもスタイルは変更されません。
Azure OpenAI トークンの制限の詳細については、「Microsoft Foundry Models の Azure OpenAI のクォータと制限」を参照してください。
フィードバックを提供する
Copilotからの各応答について、肯定的なフィードバック (サムアップ) または否定 (サムダウン) フィードバックを提供できます。 いずれかを選択すると、[ Microsoft にフィードバックを送信 ] ダイアログが表示されます。 フィードバックを表すオプションを選択し、[ 送信] を選択します。 フィードバックを送信しても、プロンプトと応答の情報は Microsoft と共有されません。
プロンプトや応答などの詳細情報を提供する場合は、詳細を指定するオプションを選択します。 [送信] を選択すると、SSMS のフィードバック サイトがブラウザーで開き、フィードバック チケットを作成できます。 最適なサポートを得る場合は、チャット履歴またはログ ファイルとチケットを含めます。 または、SSMS のヘルプフィードバックを送信からフィードバックサイトにアクセスすることもできます。