Le connessioni dati in Editor caricamento dati e Script consentono di salvare collegamenti alle sorgenti dati comunemente utilizzate: database, file locali o file remoti.
Connessioni dati elenca le connessioni salvate in ordine alfabetico raggruppate per gli spazi a cui appartengono. È possibile utilizzare la casella di ricerca per restringere l'elenco alle connessioni con un determinato nome o tipo. È possibile accedere alle Connessioni dati facendo clic su Sorgenti dati.
Creazione di una nuova connessione dati
Procedere come indicato di seguito:
-
Fare clic su Sorgenti dati.
- Fare clic su Crea nuova connessione.
-
In Spazio, selezionare lo spazio in cui verrà posizionata la connessione.
-
Selezionare nell'elenco a discesa il tipo di sorgente dati che si desiderare creare.
Viene visualizzata la finestra di dialogo delle impostazioni, specifica per il tipo di sorgente dati selezionato.
-
Immettere le impostazioni della sorgente dati e fare clic su Crea per creare la connessione dati.
Eliminazione di una connessione dati
Procedere come indicato di seguito:
Fare clic su Sorgenti dati.
- Fare clic su
sulla connessione dati che si desidera eliminare. - Confermare che si desidera eliminare la connessione.
La connessione dati è adesso eliminata.
Modifica di una connessione dati
Procedere come indicato di seguito:
Fare clic su Sorgenti dati.
Sotto Connessioni dati, selezionare lo spazio contenente la connessione dati che si desidera modificare.
- Fare clic su
sulla connessione dati che si desidera modificare. Modificare i dettagli della connessione dati. I dettagli della connessione sono specifici del tipo di connessione.
Potrebbe essere necessario fornire le credenziali della connessione.
La connessione dati è adesso aggiornata.
Informazioni sulle connessioni DataFiles
Le connessioni DataFiles vengono create automaticamente per ogni spazio a cui l'utente può accedere. Le connessioni sono disponibili da ciascuna sezione degli spazi sotto Connessioni dati.
Selezione di dati da una connessione dati
Se si desidera selezionare da una connessione dati i dati da caricare nell'app, procedere come indicato di seguito:
Fare clic su Sorgenti dati.
- Fare clic su Crea nuova connessione che collega alla sorgente dati (se la connessione dati non esiste già).
Selezionare i dati dalla connessione.
Riferimento a una connessione dati nello script
È possibile utilizzare la connessione dati per fare riferimento a sorgenti dati in istruzioni e funzioni dello script, in genere quando si desidera fare riferimento a un nome file con un percorso.
In Qlik Cloud Analytics, la sintassi per aggiungere un riferimento a un file nello script di caricamento è la seguente:
[lib://(nome_spazio):(nome_connessione)/(nome_cartella)/(nome_file)]
È necessario fornire il percorso completo della cartella. I percorsi relativi non sono supportati.
Se lo spazio non esiste, l'istruzione non può essere eseguita e restituisce un errore.
Il percorso della cartella può includere più cartelle in una struttura gerarchica. Ogni nome_cartella nel percorso deve essere delimitato con i caratteri /.
Quando si fa riferimento ai file che risiedono in una struttura di cartelle, nel percorso non sono ammessi i seguenti elementi:
//
\
\\
/./
/../
I simboli del punto finale (.) nello spazio, nella cartella o nel nome file sono accettabili, purché non compaiano nelle configurazioni dell'elenco precedente.
Esempi: Sintassi non conforme
Questi esempi sono considerati come sintassi non valida per il percorso:
A seconda del tipo di istruzione utilizzata per lo script, la sintassi non conforme potrebbe causare un errore di ricarica o potrebbe comunque essere eseguita con un comportamento diverso. Per dettagli specifici, vedere:
Non è necessario aggiungere nome_spazio se si desidera connettersi a uno spazio personale.
Esempio: caricamento di un file da una connessione DataFiles
In questo esempio viene caricato il file orders.csv da uno spazio personale definito nella connessione dati Data.
LOAD * FROM [lib://DataFiles/orders.csv];In questo esempio viene caricato il file orders.csv da uno spazio condiviso definito nella connessione dati Data.
LOAD * FROM [lib://TeamSharedConnection:DataFiles/orders.csv];In questo esempio viene caricato il file orders_Europe.csv dalla cartella Orders By Region in uno spazio personale.
LOAD * FROM [lib://DataFiles/Orders By Region/orders_Europe.csv];Questo esempio carica il file orders_Europe.csv dalla cartella Orders By Region in uno spazio condiviso, gestito o da uno spazio dati. Il nome dello spazio è SalesSpace.
LOAD * FROM [lib://SalesSpace:DataFiles/Orders By Region/orders_Europe.csv];In questo esempio viene caricato il file orders.csv dallo spazio corrente. Se l'app viene spostata in un altro spazio, ad esempio, utilizzerà il file orders.csv nel nuovo spazio.
LOAD * FROM [lib://:DataFiles/orders.csv];Esempio: caricamento da un database nello spazio personale corrente dell'utente
In questo esempio viene caricata la tabella Sales_data dalla connessione di database DataSource nello spazio personale di un utente.
LIB CONNECT TO 'DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;Esempio: Caricamento da un database a un altro spazio
In questo esempio viene caricata la tabella Sales_data dalla connessione di database DataSource nello spazio corrente.
LIB CONNECT TO ':DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;Esempio: Caricamento da un database a uno spazio specifico
In questo esempio viene caricata la tabella Sales_data alla connessione di database DataSource nello spazio SalesSpace.
LIB CONNECT TO 'SalesSpace:DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;Esempi: Caricamento da connessioni di analisi
I seguenti esempi mostrano come scrivere espressioni per caricare i dati dalle connessioni di analisi. Utilizzare la sintassi SSE per connettersi ai dati da una connessione di analisi.
I seguenti esempi dimostrano l'utilizzo delle connessioni negli script. Per esempi su come fare riferimento alle connessioni di analisi nei grafici, vedere Utilizzo delle connessioni di analisi e della sintassi delle estensioni lato server.
Caricamento da una connessione di analisi nello spazio corrente
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":":Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});Caricamento da una connessione di analisi nello spazio personale corrente dell'utente
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});Caricamento da una connessione di analisi in uno spazio specifico
In questo esempio i dati vengono caricati dalla connessione denominata Amazon_Titan_(Amazon_Bedrock) nello spazio SalesSpace.
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"SalesSpace:Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});