資格情報ガイド
Adobe Experience Platform Query Serviceを使用すれば、外部のクライアントと連携できます。 期限切れの資格情報または期限切れでない資格情報を使用して、これらの外部クライアントに接続できます。
資格情報の期限切れ expiring-credentials
期限切れの資格情報を使用して、外部クライアントへの接続をすばやく設定できます。
「資格情報の有効期限」セクションには、次の情報が表示されます。
- ホスト: クライアントを接続するホストの名前。 これには、Experience Platform UIの上部のリボンに表示される組織名が組み込まれます。
- Port：接続するホストのポート番号。
- データベース: クライアントを接続するデータベースの名前。
- ユーザー名: クエリサービスへの接続に使用されるユーザー名。
- パスワード: クエリサービスへの接続に使用するパスワード。 UIのパスワードはセキュリティのためにハッシュ化されています。 コピーアイコンを選択します（
- PSQL コマンド: コマンドラインでPSQLを使用してクエリサービスに接続するための関連情報をすべて自動的に挿入したコマンド。
- 有効期限：有効期限が切れる資格情報の有効期限の日時。 トークンのデフォルトの有効期間は24時間ですが、Admin Consoleの詳細設定で変更できます。
Adobe Customer Journey Analyticsのデータにアクセスできます connect-to-customer-journey-analytics
Power BIまたはTableauでCustomer Journey Analytics BI拡張機能を使用して、SQLでCustomer Journey Analytics データビューにアクセスします。 BI拡張機能と統合することで、Query Service セッション内でデータビューに直接アクセスできます。 この統合により、Query ServiceをPostgreSQL インターフェイスとして使用するBI ツールの機能が合理化されます。 この機能により、BI ツールでデータビューを複製する必要がなくなり、プラットフォーム間で一貫したレポート作成が可能になり、Customer Journey AnalyticsデータとBI プラットフォーム内の他のソースとの統合が簡素化されます。
Power BIやTableauなど、さまざまなデスクトップクライアントアプリケーション 🔗にQuery Serviceを接続する方法については、ドキュメントを参照してください
Power BIまたはTableauでCustomer Journey Analytics データにアクセスするには、Database ドロップダウンメニューを選択し、使用可能なオプションからprod:cjaを選択します。 次に、Power BIまたはTableau設定で使用するPostgres資格情報パラメーター（ホスト、ポート、データベース、ユーザー名など）をコピーします。
また、クエリエディターまたはPostgres CLIから直接Customer Journey Analytics データにアクセスすることもできます。 これを行うには、クエリの書き込み時にcja データベースを参照します。 クエリの作成、実行、保存の方法について詳しくは、クエリ エディター クエリ オーサリング ガイド を参照してください。
SQLを使用してCustomer Journey Analytics データビューにアクセスする方法について詳しくは、BI拡張機能ガイド を参照してください。
資格情報の期限切れなし non-expiring-credentials
有効期限のない資格情報を使用して、外部クライアントへのより永続的な接続を設定できます。
- ユーザーは、ユーザー名とパスワードを
{technicalAccountId}:{credential}形式でログインする必要があります。 詳しくは、資格情報の生成 セクションを参照してください。 - デフォルトでは、期限切れでない資格情報には、
SELECT件のクエリのみを実行するための権限が付与されます。CTASまたはITAS件のクエリを実行するには、有効期限のない資格情報に関連付けられている役割に、「データセットの管理」および「スキーマの管理」権限を手動で追加します。 「スキーマの管理」権限は「データモデリング」セクションで確認でき、「データセットの管理」権限はAdobe Developer Consoleの「データ管理」セクションにあります。 - クエリオブジェクトをリストアウトする際に、サードパーティクライアントのパフォーマンスが想定とは異なる場合があります。 例えば、DB Visualizerなどの一部のサードパーティクライアントでは、ビュー名が左側のパネルに表示されません。 ただし、
SELECTクエリ内で呼び出すと、ビュー名にアクセスできます。 同様に、PowerUIは、ダッシュボードの作成時に選択するためにSQLを通じて作成された一時ビューを一覧表示しない場合があります。
前提条件
期限切れでない資格情報を生成する前に、Adobe Admin Consoleで次の手順を実行する必要があります。
- Adobe Admin Consoleにログインし、上部のナビゲーションバーから関連する組織を選択します。
- 製品プロファイルの選択。
- 製品プロファイルの サンドボックス と Manage Query Service Integration 権限の両方を設定します。
- 製品プロファイル に新しいユーザーを追加して、設定された権限を付与します。
- アクティブな製品プロファイルのアカウント作成を許可するには、製品プロファイル管理者としてユーザーを追加します。
- 統合を作成するには、製品プロファイル開発者としてユーザーを追加します。
これらの手順の後、OAuth サーバー間の資格情報を生成し、期限切れまたは期限切れでない資格情報機能を使用するために、必要な権限がAdobe Developer Consoleで設定されます。
権限の割り当てについて詳しくは、 アクセス制御に関するドキュメント を参照してください。
資格情報を生成 generate-credentials
有効期限のない一連の資格情報を作成するには、Experience Platform UIに戻り、左側のナビゲーションから「クエリ」を選択して、 クエリ ワークスペースにアクセスします。 次に、「資格情報」タブを選択し、「資格情報を生成」を選択します。
資格情報を生成するためのダイアログが表示されます。 有効期限のない資格情報を作成するには、次の詳細を指定する必要があります。
- 名前：生成する資格情報の名前。
- 説明: （オプション）生成する資格情報の説明。
- 割り当て先：資格情報を割り当てるユーザー。 この値は、資格情報を作成するユーザーのメールアドレスである必要があります。
- パスワード （オプション）資格情報のオプションのパスワード。 パスワードが設定されていない場合、Adobeは自動的にパスワードを生成します。
必要なすべての詳細を指定したら、「資格情報を生成」を選択して、資格情報を生成します。
設定JSON ファイルには、テクニカルアカウント名、テクニカルアカウント ID、資格情報などの情報が含まれます。 次の形式で提供されます。
{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}
生成した資格情報を保存したら、閉じるを選択します。 有効期限のない資格情報のリストが表示されます。
有効期限のない資格情報を編集または削除できます。 有効期限のない資格情報を編集するには、鉛筆アイコン（
有効期限のない資格情報を編集すると、モーダルが表示されます。 以下の詳細を更新できます。
- 名前：生成する資格情報の名前。
- 説明: （オプション）生成する資格情報の説明。
- 割り当て先：資格情報を割り当てるユーザー。 この値は、資格情報を作成するユーザーのメールアドレスである必要があります。
必要なすべての詳細を指定したら、「アカウントを更新」を選択して、資格情報の更新を完了します。
OAuthへの資格情報の移行 migrate-credentials
有効期限のないJWT資格情報を使用している場合は、サービスの中断を回避するために、2025年6月30日までにOAuth サーバー間でそれぞれを移行する必要があります。
影響を受ける資格情報を特定し、移行を完了する方法については、JWTからOAuth サーバー間の資格情報ガイド を参照してください。
よくある質問については、移行に関するFAQを参照してください。
資格情報を使用して外部クライアントに接続する use-credential-to-connect
期限切れまたは期限切れでない資格情報を使用して、Aqua Data Studio、Looker、Power BIなどの外部クライアントと接続できます。 これらの資格情報の入力方法は、外部クライアントによって異なります。 これらの資格情報の使用に関する具体的な手順については、外部クライアントのドキュメントを参照してください。
この画像は、有効期限のない資格情報のパスワードを除いて、UIで見つかった各パラメーターの場所を示します。 有効期限のない資格情報は、JSON設定ファイルによって提供されますが、UIの「資格情報」タブで、有効期限が切れる資格情報を表示できます。
次の表は、外部クライアントへの接続に通常必要なパラメーターの概要を示しています。
ユーザー名とパスワードを入力するための形式では、この例
username:{your_username}とpassword:{password_string}に示すように、コロン区切りの値を使用します。接続先のサーバー/ホストの名前。
- この値は、期限切れの資格情報と期限切れでない資格情報の両方に使用され、
server.adobe.ioの形式になります。 値は、資格情報の有効期限 セクションの ホスト の下にあります。
acme.platform.adobe.io接続先のサーバー/ホストのポート。
- この値は、期限切れの資格情報と期限切れでない資格情報の両方に使用され、期限切れの資格情報 セクションの ポート にあります。
80接続先のデータベース。
- この値は、期限切れの資格情報と期限切れでない資格情報の両方に使用され、期限切れの資格情報 セクションの データベース にあります。
prod:all外部クライアントに接続しているユーザーのユーザー名。
- この値は、期限切れの資格情報と期限切れでない資格情報の両方に使用されます。
@AdobeOrgの前に英数字の文字列が表示されます。 この値は ユーザー名 の下にあります。
ECBB80245ECFC73E8A095EC9@AdobeOrg外部クライアントに接続しているユーザーのパスワード。
- 期限切れの資格情報を使用している場合は、期限切れの資格情報 セクション内の パスワード に記載されています。
- 期限切れでない資格情報を使用している場合、この値は、technicalAccountIDの連鎖引数と設定JSON ファイルから取得された資格情報です。 パスワードの値は
{technicalAccountId}:{credential}形式で指定します。
- 有効期限が切れる資格情報パスワードは、1000文字を超える英数字の文字列です。 実例は挙げられない。
- 有効期限のない資格情報パスワードは次のとおりです：
4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee
次の手順
これで、期限切れの資格情報と期限切れでない資格情報の両方がどのように機能するかを理解できたので、これらの資格情報を使用して外部クライアントに接続できます。 外部クライアントについて詳しくは、 クライアントをクエリサービスに接続ガイド を参照してください。