ドキュメントExperience Platformクエリサービスガイド

GitHub Copilot と Visual Studio Code のクエリサービスへの接続

最終更新日: 2025年5月5日
  • トピック:

作成対象:

  • ユーザー
  • 開発者
IMPORTANT
この統合ツールを使用する前に、GitHub と共有されるデータを理解する必要があります。 共有データには、編集中のコードとファイルに関するコンテキスト情報(「プロンプト」)と、ユーザーアクションに関する詳細(「ユーザーエンゲージメントデータ」)が含まれます。 収集したデータについて詳しくは 🔗 GitHub Copilot のプライバシーに関する声明を参照してください。 また、組織のデータガバナンスポリシーへの準拠を確保する責任を負うので、サードパーティのサービスを含める場合のセキュリティへの影響を考慮する必要があります。 Adobeは、このツールの使用から生じる可能性のあるデータ関連の問題に対して責任を負いません。 詳しくは、GitHub のドキュメントを参照してください。

OpenAI Codex を活用した GitHub Copilot は、コードスニペットや機能全体をエディター内で直接提案することで、コーディングエクスペリエンスを強化する AI 駆動のツールです。 Visual Studio Code (VS Code)と統合す Copilot と、特に複雑なクエリを扱う場合に、ワークフローを大幅に高速化できます。 このガイドに従って、GitHub Copilot と VS Code をクエリサービスに接続し、クエリを記述して管理をより効率的に行う方法を学習します。 Copilot について詳しくは、GitHub のコパイロット製品ページおよび 公式 Copilot ドキュメントを参照してください。

このドキュメントでは、GitHub Copilot と VS Code をAdobe Experience Platform クエリサービスに接続するために必要な手順について説明します。

基本を学ぶ

このガイドでは、GitHub アカウントに既にアクセスし、GitHub Copilot に新規登録している必要があります。 GitHub web サイトから新規登録できます。 また、VS Code も必要です。 公式サイトからダウンロード VS Code できます。

VS Code をインストールして Copilot サブスクリプションをアクティベートしたら、Experience Platformの接続資格情報を取得します。 これらの資格情報は、Experience Platform UI の ​ クエリ ​ ワークスペースの ​ 資格情報 ​ タブにあります。 詳しくは、資格情報ガイド Experience Platform UI でこれらの値を見つける方法を参照を参照してください。 現在、​ クエリ ​ ワークスペースにアクセスできない場合は、組織の管理者にお問い合わせください。

必要な Visual Studio Code 拡張機能

コードエディター内でExperience Platform SQL データベースを効果的に管理およびクエリするには、次の Visual Studio Code 拡張機能が必要です。 これらの拡張機能をダウンロードしてインストールします。

  • SQLTools:複数の SQL データベースを管理およびクエリするには、SQLTools 拡張機能を使用します。 クエリランナー、SQL フォーマッター、接続エクスプローラーなどの機能が含まれ、追加のドライバーをサポートして開発者の生産性を高めます。 詳しくは、Visual Studio Marketplace の概要を参照してください。
  • SQLTools PostgreSQL/Cockroach Driver:この拡張機能を使用すると、コードエディター内で PostgreSQL データベースと CockroachDB データベースを直接接続、クエリ、管理できます。

次の拡張機能では、GitHub Copilot とそのチャット機能が有効になります。

  • GitHub Copilot:入力時にインラインコーディングの候補を表示します。
  • GitHub Copilot チャット:会話 AI サポートを提供するコンパニオン拡張機能。

接続を作成

円柱アイコンを選択します( 円柱アイコン )(VS Code の左側のナビゲーションで、続いて Add New Connection または円柱のプラスアイコン( 円柱のプラスアイコン。 )を選択します。

SQL ツール拡張機能と「新しい接続を追加」がハイライト表示された Visual Studio Code UI。

Connection Assistant が表示されます。PostgreSQL データベース ドライバを選択します。

PostgreSQl がハイライト表示された VS Code の SQLTools 設定ページ

入力接続設定

Connection Settings ビューが表示されます。 Experience Platform接続の資格情報を SQLTools フ Connection Assistant ールドの適切なフィールドに入力します。 必要な値について、次の表で説明します。

プロパティ
説明
Connection name

Prod_MySQL_Server のような説明的で、目的を明確に示す「Connection name」を指定します(例えば、MySQL サーバーの実稼動環境)。 ベストプラクティスは次のとおりです。

  • 組織の命名規則に従って、システム内で一意になるようにします。
  • 明確さを維持し、他の接続との混乱を避けるために、簡潔に保ちます。
  • 接続の機能や環境に関する関連する詳細を、名前に含めます。
Connect using
Server and Port オプションを使用して、サーバーのアドレス(ホスト名)とポート番号を指定し、Experience Platformへの直接接続を確立します
Server address
Experience Platform Postgres 資格情報で指定された ホスト 値(acmeprod.platform-query.adobe.io など)を入力します。
Port
この値は、通常、Experience Platform サービスの場合は 80 です。
Database
Experience Platform Postgres 資格情報で指定された Database 値(prod:all など)を入力します。
Username
このプロパティは組織 ID を参照します。 Experience Platform Postgres の資格情報に指定した ユーザー名 の値を入力します。
Password
このプロパティはアクセス トークンです。 Experience Platform Postgres の資格情報に指定された パスワード 値を入力します。

複数の設定がハイライト表示された接続アシスタントワークスペース

次に、「Use Password」を選択し、表示されるドロップダウンメニューから「Save as plaintext in settings」を選択します。 Password フィールドが表示されます。 このテキスト入力フィールドを使用して、アクセストークンを入力します。

パスワードを使用、ドロップダウンメニュー、パスワードフィールドがハイライト表示されています。

最後に、SSL を有効にするには、SSL 入力フィールドを選択し、表示されるドロップダウンメニューから「Enabled」を選択します。

ドロップダウンメニューで「有効」がハイライト表示された SSL フィールド。

TIP
すべての資格情報を入力したら、接続を保存する前に接続をテストできます。 ワークスペースの下部までスクロール ダウンし、[Test Connection] を選択します。
接続をテストがハイライト表示された接続アシスタントワークスペース。

接続の詳細を正しく入力したら、「Save Connection」を選択して設定を確認します。

「接続を保存」がハイライト表示された接続アシスタントワークスペース

Review connection details ビューが表示され、接続資格情報が表示されます。 接続の詳細が正確であることを確認したら、「Connect Now」を選択します。

「今すぐ接続」がハイライト表示されたレビュー接続の詳細ビュー

VS Code ワークスペースが表示され、GitHub Copilot からの提案が表示されます。

VS Code の接続された SQL セッション。

GitHub Copilot クイックガイド

Experience Platform インスタンスに接続すると、Copilot を AI コーディングアシスタントとして使用して、より速く、より自信を持ってコードを記述できます。 この節では、主な機能とその使用方法について説明します。

GitHub Copilot 入門

まず、最新バージョンの VS Code がインストールされていることを確認します。 古い VS Code バージョンを使用すると、主要な Copilot 機能が意図したとおりに動作しなくなる可能性があります。 次に、Enable Auto Completions 設定が有効になっていることを確認します。 Copilot が正常に動作している場合、ステータス バーに Copilotアイコン ( コパイロット アイコン )が表示されます(問題がある場合は、代わりに Copilot エラーアイコンが表示されます)。 Copilotアイコンを選択して ​GitHub Copilot Menu を開きます。 [GitHub Copilot Menu から [Edit Settings] を選択します。

GitHub Copilot Menu が表示され、「Copilot」アイコンと「設定を編集」がハイライト表示された VS Code エディター

オプションを下にスクロールし、Enable Auto Completions 設定のチェックボックスがオンになっていることを確認します。

「自動補完を有効にする」チェックボックスが選択およびハイライト表示された GitHub Copilot の設定パネル

コード完了

GitHub Copilot 拡張機能をインストールしてログインすると、自動的に Ghost Text という機能がアクティブになり、入力中にコード補完が提案されます。 これらの提案は、より効率的に、より少ない中断でコードを記述するのに役立ちます。 また、コメントを参考にして AI コードの候補を示すこともできます。 つまり、技術に詳しくないユーザーでも、プレーンスピーチをコードに変換して、データを調べることができます。

コード提案と GitHub Copilot アイコンがハイライト表示された VSCode UI。

TIP
特定のファイルまたは言語の Copilot を無効にする場合は、ステータスバーのアイコンを選択して無効にします。

Ghost Text の全文または一部の候補を受け入れる

GitHub Copilot がコード補完を提案する場合は、部分的または完全な提案を受け入れることができます。 Tab キーを押すと候補の全体が確定し、Control キー(またはMacの Command キー)を押しながら 右矢印 キーを押すと テキストの一部が確定します。 提案を却下するには、Esc キーを押します。

TIP
候補が表示されない場合は、ファイルの言語で Copilot が有効になっていることを確認します。

VS Code エディターで、部分的に入力されたコードの横に「ゴーストテキスト」と表示され、GitHub Copilot からかすかなグレーのテキストの提案が表示される。

代替案

代替コードの候補を順番に表示するには、Copilot ダイアログの矢印を選択します。

コパイロット代替候補パネルを表示する VS Code エディター

インラインチャットを使用

コードについて Copilot と直接チャットすることもできます。 Control (または Command) + I を使用して、インラインチャットダイアログをトリガーにします。 この機能は、コードの反復処理や、コンテキスト内の提案の絞り込みに使用されます。 コードのブロックをハイライト表示し、インラインチャットを使用して、受け入れる前に AI によって提案された別のソリューションを確認できます。

差分表示を使用したインラインチャットウィンドウ

専用のチャットビュー

専用のチャットサイドバーを使用した従来のチャットインターフェイスを使用して、アイデアや戦略を作成、コーディングの問題を解決、実装の詳細を話し合うことができます。 チャット アイコン( コパイロット チャット アイコンを選択します。 )を選択し、専用のチャットウィンドウを開 VS Code ます。

チャットアイコンがハイライト表示された GitHub Copilot チャットサイドバー。

また、履歴アイコン( 履歴アイコンを選択すると、チャット履歴にアクセスできます。 )を選択します。

次の手順

これで、コードエディターから直接Experience Platform データベースに対して効率的にクエリを実行し、GitHub Copilot の AI を利用したコード提案を使用して、SQL クエリの記述と最適化を効率化できます。 クエリの作成および実行方法について詳しくは、 クエリ実行のガイダンスを参照してください。

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb