Dokumentation Experience Platform Handbuch zum Abfragedienst

Handbuch zu Anmeldedaten

Last update: Tue Aug 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Abfragen

Erstellt für:

Benutzende
Entwickler

Mit Adobe Experience Platform Query Service können Sie eine Verbindung mit externen Clients herstellen. Sie können eine Verbindung zu diesen externen Clients herstellen, indem Sie entweder ablaufende oder nicht ablaufende Anmeldeinformationen verwenden.

NOTE

Der Bereich für Anmeldedaten steht nicht automatisch allen Benutzenden zur Verfügung. Wenden Sie sich an Ihr Adobe-Account-Team, um bei Bedarf die Aufnahme der Registerkarte Anmeldedaten in den Query Service-Arbeitsbereich anzufordern. Auf Wunsch wird diese Änderung organisationsweit durchgeführt und vom Adobe Engineering Team durchgeführt. Es handelt sich nicht um eine Einstellung, die von Benutzern gesteuert wird.

Ablaufende Anmeldeinformationen expiring-credentials

Sie können ablaufende Anmeldedaten verwenden, um schnell eine Verbindung zu einem externen Client herzustellen.

Die Registerkarte Dashboard-Anmeldedaten für Abfragen, auf der der Abschnitt Ablaufberechtigungenhervorgehoben ist.

Im Abschnitt Ablaufberechtigungen finden Sie die folgenden Informationen:

Host: Der Name des Hosts, mit dem Ihr Client verbunden werden soll. Dies beinhaltet den Namen Ihres Unternehmens, der im oberen Band der Platform-Benutzeroberfläche angezeigt wird.
Port: Die Portnummer des Hosts, mit dem eine Verbindung hergestellt werden soll.
Datenbank: Der Name der Datenbank, mit der ein Client verbunden werden soll.
Benutzername: Der Benutzername, mit dem eine Verbindung zu Query Service hergestellt wird.
Kennwort: Das Kennwort für die Verbindung mit Query Service. Passwörter in der Benutzeroberfläche wurden aus Sicherheitsgründen gehasht. Wählen Sie das Kopiersymbol ( ), um Ihre vollständigen, nicht gehashten Anmeldedaten in die Zwischenablage zu kopieren.
PSQL-Befehl: Ein Befehl, der automatisch alle relevanten Informationen eingefügt hat, damit Sie über PSQL über die Befehlszeile eine Verbindung zu Query Service herstellen können.
Läuft ab: Das Ablaufdatum und die Ablaufzeit für die ablaufenden Anmeldeinformationen. Die standardmäßige Gültigkeitsdauer des Tokens beträgt 24 Stunden. Sie kann jedoch in den erweiterten Einstellungen der Admin Console geändert werden.

TIP

Um die Sitzungsdauer für die Verbindung Ihrer ablaufenden Anmeldedaten mit Query Service zu ändern, navigieren Sie zur Admin Console 1} und wählen Sie die folgenden Optionen auf dem Bildschirm aus: Einstellungen > Datenschutz und Sicherheit > Authentifizierungseinstellungen > Erweiterte Einstellungen > Max. Sitzungsdauer.

Die Registerkarte "Admin Console settings"mit den Einstellungen für Datenschutz und Sicherheit, Authentifizierungseinstellungen und maximaler Sitzungsdauer hervorgehoben.

Weitere Informationen zu den von der Admin Console bereitgestellten erweiterten Einstellungen finden Sie in der Dokumentation zur Adobe-Hilfe .

Verbindung zu Customer Journey Analytics-Daten in Abfragesitzungen herstellen connect-to-customer-journey-analytics

Verwenden Sie die Customer Journey Analytics BI-Erweiterung mit Power BI oder Tableau, um auf Ihre Customer Journey Analytics Datenansichten mit SQL zuzugreifen. Durch die Integration von Query Service mit der BI-Erweiterung können Sie direkt in Query Service-Sitzungen auf Ihre Datenansichten zugreifen. Diese Integration optimiert die Funktionalität für BI-Tools, die Query Service als PostgreSQL-Schnittstelle verwenden. Dadurch entfällt die Notwendigkeit, Datenansichten in BI-Tools zu duplizieren, sorgt für eine plattformübergreifende konsistente Berichterstellung und vereinfacht die Integration von Customer Journey Analytics-Daten mit anderen Quellen in BI-Plattformen.

In der Dokumentation erfahren Sie, wie Sie Query Service mit verschiedenen Desktop-Client-Anwendungen verbinden, z. B. Power BI oder Tableau

IMPORTANT

Für die Verwendung dieser Funktion sind ein Customer Journey Analytics Workspace-Projekt und eine Datenansicht erforderlich.

Um auf Ihre Customer Journey Analytics-Daten in Power BI oder Tableau zuzugreifen, wählen Sie das Dropdown-Menü Datenbank und dann prod:cja aus den verfügbaren Optionen aus. Kopieren Sie anschließend Ihre Parameter für Postgres-Anmeldedaten (Host, Port, Datenbank, Benutzername und andere) zur Verwendung in Ihrer Power BI- oder Tableau-Konfiguration.

Die Registerkarte Anmeldeinformationen für Query Servicemit dem Dropdown-Menü Datenbank.

NOTE

Wenn Sie Power BI oder Tableau mit Customer Journey Analytics verbinden, wird die Berechtigung "Gleichzeitige Sitzungen"des Abfragedienstes genutzt. Wenn zusätzliche Sitzungen und Abfragen erforderlich sind, kann ein zusätzliches Ad-hoc-Abfragebenutzer-Pack-Add-on erworben werden, um fünf weitere gleichzeitige Sitzungen und eine zusätzliche gleichzeitige Abfrage zu erhalten.

Sie können auch direkt über den Abfrage-Editor oder die Postgres-CLI auf Ihre Customer Journey Analytics-Daten zugreifen. Referenzieren Sie dazu beim Schreiben Ihrer Abfrage die cja -Datenbank. Weitere Informationen zum Schreiben, Ausführen und Speichern von Abfragen finden Sie im Leitfaden zum Abfragen-Editor Query Authoring .

Vollständige Anweisungen zum Zugriff auf Ihre Customer Journey Analytics-Datenansichten mit SQL finden Sie im BI-Erweiterungshandbuch .

Unbefristete Anmeldedaten non-expiring-credentials

Sie können nicht ablaufende Anmeldedaten verwenden, um eine permanentere Verbindung zu einem externen Client einzurichten.

NOTE

Für nicht ablaufende Anmeldedaten gelten die folgenden Einschränkungen:

Benutzer müssen sich mit ihrem Benutzernamen und Kennwort im Format {technicalAccountId}:{credential} anmelden. Weitere Informationen finden Sie im Abschnitt Anmeldeinformationen generieren .
Standardmäßig erhalten nicht ablaufende Anmeldeinformationen die Berechtigung, nur SELECT -Abfragen auszuführen. Um CTAS - oder ITAS -Abfragen auszuführen, fügen Sie manuell die Berechtigungen "Datensatz verwalten"und "Schemas verwalten"zu der Rolle hinzu, die der nicht ablaufenden Berechtigung zugeordnet ist. Die Berechtigung "Schemas verwalten"finden Sie im Abschnitt "Datenmodellierung"und die Berechtigung "Datensätze verwalten"finden Sie im Abschnitt "Datenverwaltung"von [Adobe Developer Console] (https://developer.adobe.com/console/).
Bei der Auflistung von Abfrageobjekten kann es vorkommen, dass Clients von Drittanbietern eine andere Leistung als erwartet ausführen. Einige Clients von Drittanbietern wie DB Visualizer zeigen beispielsweise den Ansichtsnamen nicht im linken Bereich an. Der Ansichtsname ist jedoch verfügbar, wenn er in einer SELECT -Abfrage aufgerufen wird. Entsprechend listet PowerUI die temporären Ansichten, die über SQL zur Auswahl bei der Dashboard-Erstellung erstellt wurden, möglicherweise nicht auf.

Voraussetzungen

Bevor Sie nicht ablaufende Anmeldeinformationen generieren können, müssen Sie die folgenden Schritte in Adobe Admin Console ausführen:

Melden Sie sich bei Adobe Admin Console an und wählen Sie in der oberen Navigationsleiste die entsprechende Organisation aus.
Wählen Sie ein Produktprofil aus.
Konfigurieren Sie sowohl die Berechtigungen Sandboxes als auch die Berechtigung Query Service Integration verwalten für das Produktprofil.
Fügen Sie einem Produktprofil einen neuen Benutzer hinzu, damit ihm die konfigurierten Berechtigungen erteilt werden.
Fügen Sie den Benutzer als Produktprofiladministrator hinzu, um die Erstellung eines Kontos für jedes aktive Produktprofil zu ermöglichen.
Fügen Sie den Benutzer als Produktprofilentwickler hinzu, um eine Integration zu erstellen.

Weitere Informationen zum Zuweisen von Berechtigungen finden Sie in der Dokumentation zu Zugriffskontrolle.

Alle erforderlichen Berechtigungen sind jetzt in Adobe Developer Console konfiguriert, damit der Benutzer die Funktion für ablaufende Anmeldedaten verwenden kann.

Anmeldedaten erstellen generate-credentials

Um einen Satz nicht ablaufender Anmeldedaten zu erstellen, kehren Sie zur Platform-Benutzeroberfläche zurück und wählen Sie im linken Navigationsbereich Abfragen aus, um auf den Arbeitsbereich Abfragen zuzugreifen. Wählen Sie als Nächstes die Registerkarte Anmeldeinformationen und danach Anmeldeinformationen generieren aus.

Das Dashboard Abfragenmit der Registerkarte Anmeldeinformationenund hervorgehobenen Anmeldeinformationen generieren.

Es wird ein Dialogfeld angezeigt, in dem Sie Anmeldeinformationen generieren können. Um nicht ablaufende Anmeldedaten zu erstellen, müssen Sie die folgenden Details angeben:

Name: Der Name der Anmeldeinformationen, die Sie generieren.
Beschreibung: (Optional) Eine Beschreibung für die Anmeldeinformationen, die Sie generieren.
Zugeordneter Benutzer: Der Benutzer, dem die Anmeldeinformationen zugewiesen werden. Dieser Wert sollte die E-Mail-Adresse des Benutzers sein, der die Anmeldeinformationen erstellt.
Kennwort (Optional) Ein optionales Kennwort für Ihre Anmeldedaten. Wenn das Kennwort nicht festgelegt ist, generiert Adobe automatisch ein Kennwort für Sie.

Nachdem Sie alle erforderlichen Details angegeben haben, wählen Sie Anmeldeinformationen generieren aus, um Ihre Anmeldeinformationen zu generieren.

Das Dialogfeld Anmeldeinformationen generierenist hervorgehoben.

IMPORTANT

Wenn Anmeldeinformationen generieren ausgewählt ist, wird eine JSON-Konfigurationsdatei auf Ihren lokalen Computer heruntergeladen. Da Adobe die generierten Anmeldeinformationen nicht aufzeichnet, müssen Sie die heruntergeladene Datei sicher speichern und einen Datensatz mit den Anmeldedaten speichern.

Wenn die Anmeldeinformationen 90 Tage lang nicht verwendet werden, werden die Anmeldeinformationen ebenfalls gelöscht.

Die JSON-Konfigurationsdatei enthält Informationen wie den Namen des technischen Kontos, die technische Konto-ID und die Anmeldedaten. Sie wird im folgenden Format bereitgestellt.

{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}

Nachdem Sie die generierten Anmeldeinformationen gespeichert haben, wählen Sie Schließen aus. Sie können jetzt eine Liste aller nicht ablaufenden Anmeldedaten anzeigen.

Die Registerkarte Dashboard-Anmeldedaten für Abfragen, auf der der Abschnitt Nicht ablaufende Anmeldedatenhervorgehoben ist.

Sie können Ihre nicht ablaufenden Anmeldedaten entweder bearbeiten oder löschen. Um eine nicht ablaufende Berechtigung zu bearbeiten, wählen Sie das Stiftsymbol ( ). Um eine nicht ablaufende Berechtigung zu löschen, wählen Sie das Löschsymbol ( ).

Beim Bearbeiten einer nicht ablaufenden Berechtigung wird ein Modal angezeigt. Sie können die folgenden Details zur Aktualisierung angeben:

Name: Der Name der Anmeldeinformationen, die Sie generieren.
Beschreibung: (Optional) Eine Beschreibung für die Anmeldeinformationen, die Sie generieren.
Zugeordneter Benutzer: Der Benutzer, dem die Anmeldeinformationen zugewiesen werden. Dieser Wert sollte die E-Mail-Adresse des Benutzers sein, der die Anmeldeinformationen erstellt.

Das Dialogfeld Konto aktualisieren.

Nachdem Sie alle erforderlichen Details angegeben haben, wählen Sie Konto aktualisieren aus, um die Aktualisierung Ihrer Anmeldedaten abzuschließen.

Verwenden Sie Anmeldeinformationen, um eine Verbindung zu externen Clients herzustellen. use-credential-to-connect

Sie können die ablaufenden oder nicht ablaufenden Anmeldedaten verwenden, um eine Verbindung mit externen Clients wie Aqua Data Studio, Looker oder Power BI herzustellen. Die Eingabemethode für diese Anmeldeinformationen variiert je nach externem Client. Spezifische Anweisungen zur Verwendung dieser Anmeldeinformationen finden Sie in der Dokumentation des externen Kunden.

Das Bild zeigt den Speicherort der einzelnen Parameter in der Benutzeroberfläche an, mit Ausnahme des Kennworts der nicht ablaufenden Anmeldeinformationen. Während nicht ablaufende Anmeldedaten von ihren JSON-Konfigurationsdateien bereitgestellt werden, können Sie Ihre ablaufenden Anmeldedaten auf der Registerkarte Anmeldedaten in der Benutzeroberfläche anzeigen.

Die Registerkarte Anmeldeinformationen des Arbeitsbereichs Abfragen, auf der der Abschnitt Ablaufberechtigungen hervorgehoben ist.

In der folgenden Tabelle sind die Parameter aufgeführt, die normalerweise für die Verbindung mit externen Clients erforderlich sind.

NOTE

Beim Herstellen einer Verbindung zu einem Host mit nicht ablaufenden Anmeldeinformationen müssen weiterhin alle im Abschnitt EXPIRING CREDENTIALS aufgelisteten Parameter verwendet werden, mit Ausnahme des Kennworts und des Benutzernamens.
Das Format für die Eingabe Ihres Benutzernamens und Kennworts verwendet durch Doppelpunkte getrennte Werte, wie in diesem Beispiel username:{your_username} und password:{password_string} dargestellt.

Parameter

Beschreibung

Beispiel

Server/Host

Der Name des Servers/Hosts, mit dem Sie eine Verbindung herstellen.

Dieser Wert wird sowohl für ablaufende als auch nicht ablaufende Anmeldeinformationen verwendet und hat die Form "server.adobe.io". Der Wert befindet sich unter Host im Abschnitt EXPIRING CREDENTIALS .

acme.platform.adobe.io

Port

Der Anschluss für den Server/Host, mit dem Sie eine Verbindung herstellen.

Dieser Wert wird sowohl für ablaufende als auch für nicht ablaufende Anmeldeinformationen verwendet und befindet sich unter Port im Abschnitt EXPIRING CREDENTIALS .

80

Datenbank

Die Datenbank, mit der Sie eine Verbindung herstellen.

Dieser Wert wird sowohl für ablaufende als auch für nicht ablaufende Anmeldeinformationen verwendet und befindet sich unter Datenbank im Abschnitt EXPIRING CREDENTIALS .

prod:all

Benutzername

Der Benutzername für den Benutzer, der eine Verbindung zum externen Client herstellt.

Dieser Wert wird sowohl für ablaufende als auch für nicht ablaufende Anmeldeinformationen verwendet. Sie hat die Form einer alphanumerischen Zeichenfolge vor @AdobeOrg. Dieser Wert befindet sich unter Benutzername.

ECBB80245ECFC73E8A095EC9@AdobeOrg

Passwort

Das Kennwort für den Benutzer, der eine Verbindung zum externen Client herstellt.

Wenn Sie ablaufende Anmeldeinformationen verwenden, finden Sie dies unter Kennwort im Abschnitt EXPIRING CREDENTIALS .
Wenn Sie nicht ablaufende Anmeldeinformationen verwenden, ist dieser Wert die verketteten Argumente aus der technicalAccountID und die Berechtigung aus der JSON-Konfigurationsdatei. Der Kennwortwert hat das folgende Format: {technicalAccountId}:{credential}.

Ein ablaufendes Berechtigungskennwort ist mehr als tausend Zeichen eine alphanumerische Zeichenfolge. Es wird kein Beispiel gegeben.
Ein nicht ablaufendes Berechtigungskennwort lautet wie folgt:
4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee

Nächste Schritte

Nachdem Sie nun wissen, wie ablaufende und nicht ablaufende Anmeldeinformationen funktionieren, können Sie diese Anmeldeinformationen verwenden, um eine Verbindung zu externen Clients herzustellen. Weitere Informationen zu externen Clients finden Sie im Handbuch Clients mit Query Service verbinden.

recommendation-more-help

ccf2b369-4031-483f-af63-a93b5ae5e3fb