Documentatie Experience Platform Gids voor Query Service

Referentiegids

Laatst bijgewerkt: 13 augustus 2024

Onderwerpen:
Query's

Gemaakt voor:

Gebruiker
Ontwikkelaar

Met Adobe Experience Platform Query Service kunt u verbinding maken met externe clients. U kunt met deze externe cliënten verbinden door of het verlopen van geloofsbrieven of niet-vervallende geloofsbrieven te gebruiken.

NOTE

Het venster Referenties is niet automatisch beschikbaar voor alle gebruikers. Neem contact op met het accountteam van de Adobe om te vragen dat het tabblad Credentials wordt opgenomen in de werkruimte van de Query-service als u dit nodig hebt. Indien gevraagd, is deze verandering organisatie wijd en door het technische team van Adobe geleid. Dit is geen instelling die door gebruikers wordt beheerd.

Referenties vervallen

U kunt verlopen referenties gebruiken om snel een verbinding met een externe client in te stellen.

het lusje van Referenties van het dashboard van Vragen met de Verdere benadrukte geloofsbrieven sectie.

De sectie Expiring credentials bevat de volgende informatie:

Host: De naam van de host waarmee de client verbinding moet maken. Dit neemt de naam van uw organisatie zoals die in het hoogste lint van het Platform UI wordt gezien op.
Port: Het poortnummer van de host waarmee verbinding moet worden gemaakt.
Database: De naam van de database waarmee een client verbinding moet maken.
Username: De gebruikersnaam die wordt gebruikt om verbinding te maken met Query Service.
Password: Het wachtwoord dat wordt gebruikt om verbinding te maken met Query Service. De wachtwoorden in UI zijn gehakt voor veiligheid. Selecteer het exemplaarpictogram ( ) om uw volledige, niet-gehashte gegevens naar het klembord te kopiëren.
PSQL command: Een bevel dat automatisch alle relevante informatie voor u om met de Dienst van de Vraag gebruikend PSQL op de bevellijn heeft opgenomen te verbinden.
Expires: De verloopdatum en -tijd voor de verloopgegevens. De standaard geldigheidstermijn van het token is 24 uur, maar deze kan worden gewijzigd in de geavanceerde instellingen van de Admin Console.

TIP

Om het zittingsleven voor uw het verlopen geloofsbrieven verbinding aan de Dienst van de Vraag te veranderen, navigeer aan de Admin Consoleen selecteer het volgende op het schermopties: Montages > Privacy en Veiligheid > Montages van de Authentificatie > Geavanceerde montages > Max zittingsleven.

het lusje van de montages van de Admin Console met Privacy en Veiligheid, de montages van de Authentificatie, en Max benadrukt zittingsleven.

Zie de documentatie van de Hulp van de Adobe voor meer informatie over de Geavanceerde montagesdie door Admin console worden aangeboden.

Verbinding maken met Customer Journey Analytics-gegevens binnen querysessies

Gebruik de uitbreiding van Customer Journey Analytics BI met Power BI of Tableau om tot uw Customer Journey Analytics gegevensmeningenmet SQL toegang te hebben. Door de Dienst van de Vraag met de uitbreiding te integreren BI, kunt u tot uw gegevensmeningen direct binnen de zittingen van de Dienst van de Vraag toegang hebben. Deze integratie stroomlijnt functionaliteit voor hulpmiddelen BI die de Dienst van de Vraag als hun interface PostgreSQL gebruiken. Deze functionaliteit elimineert de behoefte om gegevensmeningen in hulpmiddelen van BI te dupliceren, verzekert verenigbare rapportering over platforms, en vereenvoudigt de integratie van de gegevens van de Customer Journey Analytics met andere bronnen in platforms van BI.

Zie de documentatie leren hoe te om de Dienst van de Vraag aan een verscheidenheid van de toepassingen van de Desktopcliënt 🔗 zoals Power BIof Tableaute verbinden

IMPORTANT

Voor het gebruik van deze functionaliteit zijn een Customer Journey Analytics-werkruimteproject en een gegevensweergave vereist.

Als u toegang wilt krijgen tot de gegevens van uw Customer Journey Analytics in Power BI of Tableau, selecteert u het vervolgkeuzemenu Database en selecteert u prod:cja in de beschikbare opties. Kopieer vervolgens de Postgres verificatieparameters (Host, Poort, Database, Gebruikersnaam en andere) voor gebruik in de configuratie van Power BI of Tableau.

het lusje van de geloofsbrieven van de Dienst van de Vraag met benadrukt gegevensbestand dropdown.

NOTE

Wanneer u Power BI of Tableau met Customer Journey Analytics verbindt, wordt de "gezamenlijke zittingen"van de Dienst van de Vraag het recht verbruikt. Als extra sessies en query's vereist zijn, kan een extra add-on voor het pakket voor gebruikers van ad-hocquery's worden aangeschaft om vijf extra gelijktijdige sessies en één extra gelijktijdige query te verkrijgen.

U kunt tot uw gegevens van de Customer Journey Analytics rechtstreeks van de Redacteur van de Vraag of CLI van Postgres toegang hebben. U doet dit door naar de cja -database te verwijzen wanneer u uw query schrijft. Zie de redacteur van de Vraag vraag auteursgidsvoor meer informatie over hoe te schrijven, uit te voeren en, vragen te bewaren.

Zie de de uitbreidingsgids van BIvoor volledige instructies bij de toegang tot van uw de gegevensmeningen van de Customer Journey Analytics met SQL.

Niet-verlopen referenties

U kunt niet-verlopen geloofsbrieven gebruiken aan opstelling een duurdere verbinding aan een externe cliënt.

NOTE

Niet-vervallende referenties hebben de volgende beperkingen:

Gebruikers moeten zich aanmelden met hun gebruikersnaam en wachtwoord in de notatie {technicalAccountId}:{credential} . Meer informatie kan in worden gevonden produceert geloofsbrievensectie.
Standaard krijgen niet-verlopen referenties machtigingen om alleen SELECT query's uit te voeren. Als u CTAS - of ITAS -query's wilt uitvoeren, voegt u de machtigingen Gegevensset beheren en Schema's beheren handmatig toe aan de rol die is gekoppeld aan de niet-vervallende referentie. De "Manage Schemas"toestemming kan onder de "Modeling van Gegevens"sectie worden gevonden, en de "Manage toestemmingen van Datasets"wordt gevestigd onder de "sectie van het Beheer van Gegevens"van Adobe Developer Console.
Externe clients kunnen anders presteren dan u had verwacht bij het weergeven van queryobjecten. Sommige clients van derden, zoals DB Visualizer , geven de weergavenaam bijvoorbeeld niet weer in het linkerdeelvenster. De weergavenaam is echter toegankelijk als deze wordt aangeroepen binnen een query SELECT . Op dezelfde manier geeft PowerUI mogelijk geen lijst weer van de tijdelijke weergaven die met SQL zijn gemaakt voor selectie in het maken van dashboard.

Vereisten

Voordat u niet-vervallende gegevens kunt genereren, moet u de volgende stappen in Adobe Admin Console uitvoeren:

Logboek in Adobe Admin Consoleen selecteert relevante Org van de hoogste navigatiebar.
Selecteer een productprofiel.
vormt zowel de Sandboxes als de Toestemmingen van de Integratie van de Dienst van de Vraagvoor het productprofiel.
voeg een nieuwe gebruiker aan een productprofieltoe zodat worden zij verleend zijn gevormde toestemmingen.
voeg de gebruiker als admin van het productprofieltoe om een rekeningsverwezenlijking voor om het even welk actief productprofiel toe te staan.
voeg de gebruiker als ontwikkelaar van het productprofieltoe om een integratie tot stand te brengen.

Meer over leren hoe te om toestemmingen toe te wijzen, te lezen gelieve de documentatie op toegangsbeheer.

Alle vereiste toestemmingen worden nu gevormd in Adobe Developer Console voor de gebruiker om de het verlopen geloofsbrieven eigenschap te gebruiken.

Referenties genereren

Als u een set niet-vervallende gegevens wilt maken, gaat u terug naar de gebruikersinterface van het platform en selecteert u Queries in de linkernavigatie voor toegang tot de Queries -werkruimte. Selecteer vervolgens de tab Credentials gevolgd door Generate credentials .

het dashboard van Vragen met het lusje van Geloofsbrieven en produceer benadrukte geloofsbrieven.

Er wordt een dialoogvenster weergegeven waarin u referenties kunt genereren. Als u niet-vervallende gegevens wilt maken, moet u de volgende gegevens opgeven:

Name: De naam van de referenties die u genereert.
Description: (Optioneel) Een beschrijving van de referenties die u genereert.
Assigned to: De gebruiker waaraan de referenties worden toegewezen. Deze waarde moet het e-mailadres zijn van de gebruiker die de referenties maakt.
Password (Optioneel) Een optioneel wachtwoord voor uw referenties. Als het wachtwoord niet is ingesteld, genereert de Adobe automatisch een wachtwoord voor u.

Nadat u alle vereiste gegevens hebt opgegeven, selecteert u Generate credentials om uw referenties te genereren.

de Generate dialoog van geloofsbrieven wordt benadrukt.

IMPORTANT

Als Generate credentials is geselecteerd, wordt een JSON-configuratiebestand gedownload naar uw lokale computer. Aangezien de Adobe niet de geproduceerde geloofsbrieven registreert, moet u het gedownloade dossier veilig opslaan en een verslag van de referentie houden.

Bovendien, als de geloofsbrieven niet gedurende 90 dagen worden gebruikt, zullen de geloofsbrieven worden verklaard.

Het configuratie-JSON-bestand bevat informatie zoals de naam van de technische account, de id van de technische account en de referentie. Deze wordt in het volgende formaat verstrekt.

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

Nadat u de gegenereerde gegevens hebt opgeslagen, selecteert u Close . U kunt nu een lijst zien van al uw niet-vervallende geloofsbrieven.

het lusje van Referenties van het dashboard van Vragen met de niet-vervallende benadrukte sectie van Referenties.

U kunt uw niet-vervallende gegevens bewerken of verwijderen. Om een niet-verkennende referentie uit te geven, selecteer het potloodpictogram ( ). Om een niet-expirerende referentie te schrappen, selecteer het schrappingspictogram ( ).

Wanneer u een niet-verkennende referentie bewerkt, wordt een modaal veld weergegeven. U kunt de volgende gegevens opgeven om bij te werken:

Name: De naam van de referenties die u genereert.
Description: (Optioneel) Een beschrijving van de referenties die u genereert.
Assigned to: De gebruiker waaraan de referenties worden toegewezen. Deze waarde moet het e-mailadres zijn van de gebruiker die de referenties maakt.

de de rekeningsdialoog van de Update.

Nadat u alle vereiste gegevens hebt opgegeven, selecteert u Update account om de update van uw referenties te voltooien.

Referenties gebruiken om verbinding te maken met externe clients

U kunt of de het verlopen of niet-verlopen geloofsbrieven gebruiken om met externe cliënten, zoals de Studio van Gegevens Aqua, Leider, of Power BI te verbinden. De invoermethode voor deze referenties is afhankelijk van de externe client. Raadpleeg de documentatie van de externe client voor specifieke instructies over het gebruik van deze referenties.

De afbeelding geeft de locatie aan van elke parameter die in de gebruikersinterface wordt gevonden, behalve het wachtwoord van de niet-vervallende gegevens. Terwijl niet-vervallende geloofsbrieven door hun JSON configuratiedossiers worden verstrekt, kunt u uw het verlopen geloofsbrieven onder het Credentials lusje in UI bekijken.

het lusje van de Referenties van de werkruimte van Vragen met de Verdere benadrukte geloofsbrieven van Bezoekingen.

In de onderstaande tabel worden de parameters beschreven die doorgaans vereist zijn om verbinding te maken met externe clients.

NOTE

Wanneer u verbinding maakt met een host die niet-vervallende gegevens gebruikt, moet u nog steeds alle parameters gebruiken die in de sectie EXPIRING CREDENTIALS worden vermeld, behalve het wachtwoord en de gebruikersnaam.
Voor de notatie voor het invoeren van uw gebruikersnaam en wachtwoord worden door dubbele punten gescheiden waarden gebruikt, zoals in dit voorbeeld username:{your_username} en password:{password_string} wordt getoond.

Parameter

Beschrijving

Voorbeeld

Server/Gastheer

De naam van de server/host waarmee u verbinding maakt.

Deze waarde wordt gebruikt voor zowel verlopen als niet-verlopen referenties en heeft de vorm van server.adobe.io . De waarde staat onder Host in de EXPIRING CREDENTIALS -sectie.

acme.platform.adobe.io

Haven

De poort voor de server/host waarmee u verbinding maakt.

Deze waarde wordt gebruikt voor verlopen en niet-vervallende gegevens en staat onder Port in de sectie EXPIRING CREDENTIALS .

80

Database

De database waarmee u verbinding maakt.

Deze waarde wordt gebruikt voor verlopen en niet-vervallende gegevens en wordt gevonden onder Database in de sectie EXPIRING CREDENTIALS .

prod:all

Gebruikersnaam

De gebruikersnaam voor de gebruiker die verbinding maakt met de externe client.

Deze waarde wordt gebruikt voor zowel het verlopen van geloofsbrieven als niet-vervallende geloofsbrieven. De notatie heeft de vorm van een alfanumerieke tekenreeks voor @AdobeOrg . Deze waarde staat onder Username .

ECBB80245ECFC73E8A095EC9@AdobeOrg

Wachtwoord

Het wachtwoord voor de gebruiker die verbinding maakt met de externe client.

Als u verloopt, vindt u dit onder Password in de sectie EXPIRING CREDENTIALS .
Als u niet-vervallende geloofsbrieven gebruikt, is deze waarde de samengevoegde argumenten van technicalAccountID en de referentie die uit het configuratieJSON dossier wordt genomen. De wachtwoordwaarde heeft de notatie: {technicalAccountId}:{credential}.

Een vervallend referentie-wachtwoord is meer dan duizend alfanumerieke tekens. Er wordt geen voorbeeld gegeven.
Een niet-verkennend credentiewachtwoord is als volgt:
4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee

Volgende stappen

Nu u begrijpt hoe zowel het verlopen als niet-het verlopen geloofsbrieven werken, kunt u deze geloofsbrieven gebruiken om met externe cliënten te verbinden. Voor meer informatie gedetailleerde informatie over externe cliënten, te lezen gelieve cliënten aan de gids van de Dienst van de Vraagverbinden.

recommendation-more-help