Verbinding maken met gegevensbronnen in load-scripts
Met gegevensverbindingen in de Editor voor laden van gegevens en Script kunt u snelkoppelingen opslaan bij gegevensbronnen die u vaak gebruikt: databases, lokale bestanden of externe bestanden.
Gegevensverbindingen vermelden de verbindingen die u hebt opgeslagen in alfabetische volgorde gegroepeerd op de ruimtes waartoe ze behoren. U kunt het zoekvenster gebruiken om de lijst uit te dunnen tot verbindingen met een bepaalde naam of type. Klik op Gegevensbronnen om toegang te krijgen tot Gegevensverbindingen.
Een nieuwe gegevensverbinding maken
Doe het volgende:
-
Klik op Gegevensbronnen.
- Klik op Nieuwe verbinding maken.
-
Onder Ruimte selecteert u de ruimte waarin de verbinding wordt geplaatst.
-
Selecteer uit de vervolgkeuzelijst het type gegevensbron dat u wilt maken.
Het instellingenvenster dat specifiek hoort bij het geselecteerde type gegevensbron wordt geopend.
-
Voer de instellingen van de gegevensbron in en klik op Maken om de gegevensverbinding te maken.
Een gegevensverbinding verwijderen
Doe het volgende:
Klik op Gegevensbronnen.
- Klik op op de gegevensverbinding die u wilt verwijderen.
- Bevestig dat u de verbinding wilt verwijderen.
De gegevensverbinding is nu verwijderd.
Een gegevensverbinding bewerken
Doe het volgende:
Klik op Gegevensbronnen.
Onder Gegevensverbindingen selecteert u de ruimte die de gegevensverbinding bevat die u wilt bewerken.
- Klik op op de gegevensverbinding die u wilt bewerken.
Bewerk de details van de gegevensverbinding. Verbindingsdetails zijn specifiek voor het type verbinding.
Mogelijk moet u referenties opgeven voor de verbinding.
De gegevensverbinding is nu bijgewerkt.
Over DataFiles-verbindingen
DataFiles-verbindingen worden automatisch gemaakt voor elke ruimte waartoe u toegang hebt. De verbindingen zijn beschikbaar in elke ruimte onder Gegevensverbindingen.
Gegevens voor een gegevensverbinding selecteren
Als u gegevens wilt selecteren uit een gegevensverbinding om in uw app te laden, doet u het volgende:
Klik op Gegevensbronnen.
- Nieuwe verbinding maken waarmee u een verbinding maakt met de gegevensbron (als de gegevensverbinding nog niet bestaat).
- Selecteer gegevens uit de verbinding.
Verwijzen naar een gegevensverbinding in het script
U kunt de gegevensverbinding gebruiken om te verwijzen naar gegevensbronnen in opdrachten en functies in het script, gewoonlijk waar u naar een bestandsnaam wilt verwijzen met een pad.
In Qlik Cloud Analyse is de syntaxis voor het verwijzen naar een bestand in het load-script:
[lib://(space_name):(connection_name)/(folder_name)/(file_name)]
Het volledige mappad moet worden opgegeven. Relatieve paden worden niet ondersteund.
Als de ruimte niet bestaat, kan de instructie niet worden uitgevoerd en wordt er een fout geretourneerd.
Het mappad kan meerdere mappen bevatten in een hiërarchische structuur. Elke folder_name in het pad moet worden gescheiden door het teken /.
De volgende elementen zijn niet toegestaan in het pad wanneer verwezen wordt naar bestanden in een mapstructuur:
//
\
\\
/./
/../
Navolgende puntsymbolen (.) in de ruimte, map of bestandsnaam zijn acceptabel zolang ze niet voorkomen in de configuraties in de bovenstaande lijst.
Voorbeelden: Niet-conforme syntaxis
Deze voorbeelden worden beschouwd als ongeldige syntaxis voor het pad:
Afhankelijk van het type scriptinstructie dat wordt gebruikt, kan een niet-conforme syntaxis leiden tot laadfouten, of toch worden uitgevoerd met ander gedrag. Zie voor specifieke details:
U hoeft de space_name niet toe te voegen als u verbonden bent met een persoonlijke ruimte.
Voorbeeld: een bestand laden vanuit een DataFiles-verbinding
Bij dit voorbeeld wordt het bestand orders.csv geladen vanuit een persoonlijke ruimte die is gedefinieerd in de gegevensverbinding Data.
LOAD * FROM [lib://DataFiles/orders.csv];
Bij dit voorbeeld wordt het bestand orders.csv geladen vanuit een gedeelde ruimte die is gedefinieerd in de gegevensverbinding Data.
LOAD * FROM [lib://TeamSharedConnection:DataFiles/orders.csv];
Bij dit voorbeeld wordt het bestand orders_Europe.csv geladen vanuit de map Orders By Region binnen een persoonlijke ruimte.
LOAD * FROM [lib://DataFiles/Orders By Region/orders_Europe.csv];
In dit voorbeeld wordt het bestand orders_Europe.csv geladen vanuit de map Orders By Region binnen een gedeelde, beheerde of gegevensruimte. De naam van de ruimte is SalesSpace.
LOAD * FROM [lib://SalesSpace:DataFiles/Orders By Region/orders_Europe.csv];
Bij dit voorbeeld wordt het bestand orders.csv geladen vanuit de huidige ruimte. Als de app bijvoorbeeld naar een andere ruimte wordt verplaatst, gebruikt deze het bestand orders.csv in de nieuwe ruimte.
LOAD * FROM [lib://:DataFiles/orders.csv];
Voorbeeld: laden vanuit een database in de persoonlijke ruimte van de huidige gebruiker
Bij dit voorbeeld wordt de tabel Sales_data geladen via de DataSource-databaseverbinding in de persoonlijke ruimte van een gebruiker.
LIB CONNECT TO 'DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;
Voorbeeld: Laden vanuit een database in een andere ruimte
Bij dit voorbeeld wordt de tabel Sales_data geladen via de databaseverbinding DataSource in de huidige ruimte.
LIB CONNECT TO ':DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;
Voorbeeld: Laden vanuit een database in een specifieke ruimte
Bij dit voorbeeld wordt de tabel Sales_data geladen via de DataSource databaseverbinding in de ruimte SalesSpace.
LIB CONNECT TO 'SalesSpace:DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;
Voorbeelden: Inladen via analytische verbindingen
De volgende voorbeelden tonen hoe u uitdrukkingen schrijft om gegevens te laden vanuit analytische verbindingen. Gebruik de SSE-syntaxis om verbinding te maken met gegevens van een analytische verbinding.
Deze voorbeelden tonen het gebruik van de verbindingen in scripts. Zie Analytische verbindingen en SSE-syntax gebruiken voor voorbeelden die tonen hoe u moet verwijzen naar analytische verbindingen in diagrammen.
Laden van een analytische verbinding in de huidige ruimte
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":":Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});
Laden van een analytische verbinding in de persoonlijke ruimte van de huidige gebruiker
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});
Laden van een analytische verbinding in een specifieke ruimte
In dit voorbeeld worden gegevens geladen van de verbinding met de naam Amazon_Titan_(Amazon_Bedrock) in de ruimte SalesSpace.
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"SalesSpace:Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});