Documentazione Experience Platform Guida di Query Service

Guida alle credenziali

Ultimo aggiornamento: 4 aprile 2025

Argomenti:
Query

Creato per:

Utente
Sviluppatore

Adobe Experience Platform Query Service consente di connettersi con client esterni. È possibile connettersi a questi client esterni utilizzando credenziali in scadenza o credenziali senza scadenza.

NOTE

Il pannello Credenziali non è disponibile automaticamente per tutti gli utenti. Contatta il team del tuo account Adobe per richiedere che la scheda Credenziali sia inclusa nell'area di lavoro del servizio query se necessario. Se richiesto, la modifica interessa l’intera organizzazione ed è eseguita dal team di progettazione di Adobe. Non si tratta di un’impostazione controllata dagli utenti.

Credenziali in scadenza

È possibile utilizzare le credenziali in scadenza per impostare rapidamente una connessione a un client esterno.

Scheda Credenziali del dashboard delle query con la sezione Credenziali in scadenza evidenziata.

La sezione Credenziali in scadenza fornisce le seguenti informazioni:

Host: nome dell'host a cui connettere il client. Questo incorpora il nome dell’organizzazione come visualizzato nella barra multifunzione superiore dell’interfaccia utente di Experience Platform.
Porta: numero di porta dell'host a cui connettersi.
Database: nome del database a cui connettere un client.
Nome utente: nome utente utilizzato per connettersi a Query Service.
Password: password utilizzata per la connessione a Query Service. Le password nell’interfaccia utente sono state sottoposte a hashing per motivi di sicurezza. Selezionare l'icona Copia ( ) per copiare le credenziali complete senza hash negli Appunti.
Comando PSQL: comando che ha inserito automaticamente tutte le informazioni rilevanti per la connessione a Query Service tramite PSQL nella riga di comando.
Scadenza: data e ora di scadenza delle credenziali. La durata di validità predefinita del token è di 24 ore, ma può essere modificata nelle impostazioni avanzate di Admin Console.

TIP

Per modificare la durata della sessione per la connessione delle credenziali in scadenza a Query Service, passa a Admin Console e seleziona le seguenti opzioni sullo schermo: Impostazioni > Privacy e sicurezza > Impostazioni autenticazione > Impostazioni avanzate > Durata massima sessione.

Scheda Impostazioni di Admin Console con Privacy e sicurezza, Impostazioni autenticazione e Durata massima sessione evidenziate.

Per ulteriori informazioni sulle Impostazioni avanzate offerte da Admin Console, consulta la Guida di Adobe.

Connettersi ai dati Customer Journey Analytics nelle sessioni di query

Utilizza l'estensione Customer Journey Analytics BI con Power BI o Tableau per accedere alle visualizzazioni dati di Customer Journey Analytics con SQL. Integrando Query Service con l’estensione BI, puoi accedere alle visualizzazioni dati direttamente all’interno delle sessioni di Query Service. Questa integrazione semplifica le funzionalità degli strumenti BI che utilizzano Query Service come interfaccia PostgreSQL. Questa funzionalità elimina la necessità di duplicare le visualizzazioni dati negli strumenti di business intelligence, garantisce la coerenza dei rapporti tra le piattaforme e semplifica l'integrazione dei dati Customer Journey Analytics con altre origini nelle piattaforme di business intelligence.

Consulta la documentazione per scoprire come connettere Query Service a diverse applicazioni client desktop, ad esempio Power BI o Tableau

IMPORTANT

Per utilizzare questa funzionalità sono necessari un progetto Workspace di Customer Journey Analytics e una visualizzazione dati.

Per accedere ai dati di Customer Journey Analytics in Power BI o Tableau, selezionare il menu a discesa Database, quindi selezionare prod:cja tra le opzioni disponibili. Copiare quindi i parametri delle credenziali Postgres (Host, Porta, Database, Nome utente e altri) da utilizzare nella configurazione Power BI o Tableau.

Scheda Credenziali di Query Service con il menu a discesa del database evidenziato.

NOTE

Quando si collega Power BI o Tableau a Customer Journey Analytics, viene utilizzato il diritto "sessioni simultanee" di Query Service. Se sono necessarie sessioni e query aggiuntive, è possibile acquistare un componente aggiuntivo per il pacchetto di utenti di query ad hoc per ottenere cinque sessioni simultanee aggiuntive e una query concorrente aggiuntiva.

Puoi anche accedere ai dati Customer Journey Analytics direttamente da Query Editor o Postgres CLI. A tale scopo, fare riferimento al database cja durante la scrittura della query. Per ulteriori informazioni su come scrivere, eseguire e salvare le query, vedere la guida all'authoring delle query di Query Editor.

Per istruzioni complete sull'accesso alle visualizzazioni dati di Customer Journey Analytics con SQL, consulta la BI extension guide.

Credenziali senza scadenza

È possibile utilizzare credenziali senza scadenza per impostare una connessione più permanente a un client esterno.

NOTE

Le credenziali senza scadenza presentano le seguenti limitazioni:

Gli utenti devono effettuare l'accesso con il proprio nome utente e password nel formato {technicalAccountId}:{credential}. Ulteriori informazioni sono disponibili nella sezione Genera credenziali.
Per impostazione predefinita, alle credenziali senza scadenza vengono concesse le autorizzazioni per eseguire solo SELECT query. Per eseguire le query CTAS o ITAS, aggiungere manualmente le autorizzazioni "Gestisci set di dati" e "Gestisci schemi" al ruolo associato alle credenziali senza scadenza. L'autorizzazione "Gestisci schemi" si trova nella sezione "Modellazione dati" e l'autorizzazione "Gestisci set di dati" nella sezione "Gestione dati" di Adobe Developer Console.
I client di terze parti possono ottenere prestazioni diverse da quelle previste quando si elencano oggetti di query. Ad esempio, alcuni client di terze parti come DB Visualizer non visualizzeranno il nome della visualizzazione nel pannello sinistro. Tuttavia, il nome della visualizzazione è accessibile se chiamato all'interno di una query SELECT. Analogamente, PowerUI potrebbe non elencare le viste temporanee create tramite SQL per la selezione nella creazione del dashboard.

Prerequisiti

Prima di poter generare credenziali senza scadenza, è necessario completare i seguenti passaggi in Adobe Admin Console:

Accedi a Adobe Admin Console e seleziona l'organizzazione pertinente dalla barra di navigazione superiore.
Seleziona un profilo di prodotto.
Configura le autorizzazioni Sandbox e Gestione integrazione servizio query per il profilo di prodotto.
Aggiungi un nuovo utente a un profilo di prodotto in modo che possa disporre delle autorizzazioni configurate.
Aggiungi l'utente come amministratore del profilo di prodotto per consentire la creazione di un account per qualsiasi profilo di prodotto attivo.
Aggiungi l'utente come sviluppatore del profilo di prodotto per creare un'integrazione.

Per ulteriori informazioni su come assegnare le autorizzazioni, leggere la documentazione sul controllo di accesso.

In Adobe Developer Console sono ora configurate tutte le autorizzazioni necessarie affinché l’utente possa utilizzare la funzione delle credenziali in scadenza.

Genera credenziali

Per creare un set di credenziali senza scadenza, torna all'interfaccia utente di Experience Platform e seleziona Query dal menu di navigazione a sinistra per accedere all'area di lavoro Query. Quindi, selezionare la scheda Credenziali seguita da Genera credenziali.

Dashboard delle query con la scheda Credenziali e lopzione Genera credenziali evidenziate.

Viene visualizzata una finestra di dialogo che consente di generare le credenziali. Per creare credenziali senza scadenza, è necessario fornire i dettagli seguenti:

Nome: nome delle credenziali che si stanno generando.
Descrizione: (facoltativo) una descrizione per le credenziali che si stanno generando.
Assegnato a: l'utente a cui verranno assegnate le credenziali. Questo valore deve essere l’indirizzo e-mail dell’utente che sta creando le credenziali.
Password (Facoltativo) Password facoltativa per le credenziali. Se la password non è impostata, Adobe genererà automaticamente una password.

Dopo aver fornito tutti i dettagli richiesti, selezionare Genera credenziali per generare le credenziali.

La finestra di dialogo Genera credenziali è evidenziata.

IMPORTANT

Quando è selezionata l'opzione Genera credenziali, nel computer locale viene scaricato un file JSON di configurazione. Poiché Adobe non registra le credenziali generate, è necessario archiviare in modo sicuro il file scaricato e conservare un record delle credenziali.

Inoltre, se le credenziali non vengono utilizzate per 90 giorni, verranno eliminate.

Il file JSON di configurazione contiene informazioni come il nome dell’account tecnico, l’ID dell’account tecnico e le credenziali. Viene fornito nel seguente formato.

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

Dopo aver salvato le credenziali generate, seleziona Chiudi. È ora disponibile un elenco di tutte le credenziali senza scadenza.

Scheda Credenziali del dashboard delle query con la sezione Credenziali senza scadenza evidenziata.

È possibile modificare o eliminare le credenziali senza scadenza. Per modificare una credenziale senza scadenza, selezionare l'icona della matita ( ). Per eliminare una credenziale senza scadenza, selezionare l'icona Elimina ( ).

Quando si modifica una credenziale senza scadenza, viene visualizzata una finestra modale. Puoi fornire i seguenti dettagli da aggiornare:

Nome: nome delle credenziali che si stanno generando.
Descrizione: (facoltativo) una descrizione per le credenziali che si stanno generando.
Assegnato a: l'utente a cui verranno assegnate le credenziali. Questo valore deve essere l’indirizzo e-mail dell’utente che sta creando le credenziali.

Finestra di dialogo Aggiorna account.

Dopo aver fornito tutti i dettagli richiesti, seleziona Aggiorna account per completare l'aggiornamento delle credenziali.

Utilizzare le credenziali per connettersi ai client esterni

Puoi utilizzare le credenziali in scadenza o non in scadenza per connetterti con client esterni, come Aqua Data Studio, Looker o Power BI. Il metodo di input per queste credenziali varia a seconda del client esterno. Per istruzioni specifiche sull’utilizzo di queste credenziali, consulta la documentazione del client esterno.

L’immagine indica la posizione di ciascun parametro trovato nell’interfaccia utente, ad eccezione della password delle credenziali senza scadenza. Anche se le credenziali senza scadenza vengono fornite dai relativi file di configurazione JSON, puoi visualizzare le credenziali in scadenza nella scheda Credenziali nell'interfaccia utente.

Scheda Credenziali dellarea di lavoro query con la sezione Credenziali in scadenza evidenziata.

La tabella seguente illustra i parametri normalmente necessari per la connessione ai client esterni.

NOTE

Quando ci si connette a un host utilizzando credenziali senza scadenza, è comunque necessario utilizzare tutti i parametri elencati nella sezione EXPIRING CREDENTIALS ad eccezione della password e del nome utente.
Il formato per l'immissione del nome utente e della password utilizza valori separati da due punti come mostrato in questo esempio username:{your_username} e password:{password_string}.

Parametro

Descrizione

Esempio

Server/Host

Il nome del server/host a cui ti stai connettendo.

Questo valore viene utilizzato sia per le credenziali in scadenza che per quelle senza scadenza e assume la forma di server.adobe.io. Il valore si trova in Host nella sezione EXPIRING CREDENTIALS.

acme.platform.adobe.io

Porta

Porta del server/host a cui ci si sta connettendo.

Questo valore viene utilizzato sia per le credenziali in scadenza che per quelle senza scadenza e si trova in Porta nella sezione CREDENZIALI IN SCADENZA.

80

Database

Il database a cui ci si connette.

Questo valore viene utilizzato sia per le credenziali in scadenza che per quelle senza scadenza e si trova in Database nella sezione EXPIRING CREDENTIALS.

prod:all

Nome utente

Nome utente dell'utente che si connette al client esterno.

Questo valore viene utilizzato sia per le credenziali in scadenza che per quelle senza scadenza. Deve essere una stringa alfanumerica prima di @AdobeOrg. Questo valore si trova in Nome utente.

ECBB80245ECFC73E8A095EC9@AdobeOrg

Password

Password dell'utente che si connette al client esterno.

Se utilizzi credenziali in scadenza, puoi trovarle nella sezione Password all'interno della sezione EXPIRING CREDENTIALS.
Se utilizzi credenziali senza scadenza, questo valore corrisponde agli argomenti concatenati di technicalAccountID e alle credenziali prese dal file JSON di configurazione. Il valore della password assume la forma: {technicalAccountId}:{credential}.

Una password delle credenziali in scadenza supera un migliaio di caratteri alfanumerici. Non verrà fornito alcun esempio.
La password delle credenziali senza scadenza è la seguente:
4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee

Passaggi successivi

Ora che hai compreso il funzionamento sia delle credenziali in scadenza che di quelle non in scadenza, puoi utilizzare queste credenziali per connettersi ai client esterni. Per ulteriori informazioni dettagliate sui client esterni, leggere la guida alla connessione dei client a Query Service.

recommendation-more-help