U kunt verbindingen met gegevensbronnen maken, bijwerken en delen. Als gebruiker van Oracle Analytics met de toegangsrechten 'Auteur DV-inhoud' kunt u deze acties uitvoeren.
Onderwerpen:
U kunt een verbinding maken om gegevens in die gegevensbron te analyseren.
U kunt de verbindingsdetails van een gegevensbron bijwerken.
Als u een SSL-verbinding met een Oracle database bewerkt en u een nieuw bestand cwallet.sso
moet gebruiken, klikt u in het veld Clientwallet op Selecteren en zoekt u het bestand cwallet.sso
op. Vraag de beheerder naar de locatie van het bestand cwallet.sso
.
U kunt een gegevensbronverbinding uit Oracle Analytics Cloud verwijderen. Als bijvoorbeeld het wachtwoord voor de database is gewijzigd, moet u de databaseverbinding verwijderen en een nieuwe verbinding maken.
Als de verbinding gegevenssets bevat, moet u de gegevenssets eerst verwijderen voordat u de verbinding kunt verwijderen.
U kunt toegangsrechten toewijzen aan de gegevensbronverbindingen die u maakt of beheert.
Wanneer u verbindingsdetails opgeeft in het dialoogvenster Verbinding maken of 'Inspecteren', zijn er voor sommige typen databases aanvullende configuratieopties beschikbaar.
Algemene opties
sales.example.com =(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.111)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.222)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.333)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME= salesservice.example.com)))
Massareplicatie activeren: als u een gegevensset laadt voor een werkmap, moet deze optie worden uitgeschakeld en kunt u deze optie negeren. Deze optie mag alleen door gegevensanalisten en ervaren gebruikers worden gebruikt om gegevens in een database te repliceren in een andere database.
Verificatieopties
Systeemverbinding
Klik op Kopiëren om de object-ID van de verbinding te kopiëren. Bedrijfsmodelmakers kunnen de object-ID plakken om een gegevensverbinding te identificeren en te gebruiken in Model Administration Tool (dialoogvenster 'Verbindingsgroep').
Opmerking: als u bij het maken van de initiële verbinding niet op Systeemverbinding klikt, moet u een nieuwe verbinding maken en Systeemverbinding selecteren als de verbindingsdetails later door gegevensmodelmakers moeten worden gebruikt. Met andere woorden, u kunt de verbinding niet later bewerken en deze optie dan selecteren.
Breng uzelf op de hoogte van de vereisten voor een databaseverbinding voordat u er een maakt.
Het maximum aantal databasetabellen dat in Oracle Analytics kan worden weergegeven, is 10.000. Als u meer tabellen nodig hebt, kunt u het beste uw databasebeheerder vragen om een databasegebruiker te maken met toegangsrechten voor de specifieke objecten die u wilt analyseren, en de referenties van die gebruiker opgeven wanneer u de databaseverbinding maakt.
Als u verbinding maakt met een Oracle database, Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL-server of My SQL, kunt u de standaardcitaat-ID wijzigen, zodat u gegevens met hoofdletters, kleine letters of beide kunt lezen in tabel- of kolomnamen.
select "EfG_Field" from "AbCd";
in plaats van select EfG_Field" from "AbCd;
uit te geven (hetgeen zou mislukken).U kunt REST-API's van Oracle Analytics Cloud gebruiken om verbindingen met een reeks gegevensbronnen programmatisch te beheren. Mogelijk wilt u bijvoorbeeld een script maken dat dezelfde set verbindingen maakt (of wijzigt) in zowel uw test- als productie-omgevingen voor Oracle Analytics Cloud.
Aan de hand van REST-API's kunt u voor een reeks aan gegevensbronnen verbindingen maken, bijwerken en delen. In dit onderwerp worden de soorten gegevensbronverbindingen vermeld die u met REST API's kunt beheren.
Opmerking:
REST-API voor Oracle Analytics Cloud biedt uitgebreide gegevens over elke REST-API. Zie REST-eindpunten verbinding.Ondersteunde gegevensbronnen
Verbindingsparameters
De verbindingsparameters die voor elke gegevensbron zijn vereist, zijn anders. Als u de REST-API wilt gebruiken om een verbinding te maken of bij te werken, moet u de JSON-payload-indeling kennen die voor uw gegevensbron vereist is. Zie voor meer informatie: Voorbeelden van JSON-payloads voor gegevensbronnen.
Dit zijn de algemene taken om REST-API's van Oracle Analytics Cloud te gaan gebruiken om verbindingen programmatisch te beheren. Als u de REST-API's voor het eerst gebruikt, voert u deze taken uit bij wijze van procedure.
Taak | Beschrijving | REST-API-documentatie |
---|---|---|
Inzicht krijgen in vereisten |
Inzicht krijgen in verschillende vereiste taken en deze voltooien U moet toestemming hebben om werkmappen te maken en verbinding te maken met gegevens in Oracle Analytics Cloud om gegevensverbindingen te beheren met REST-API's (Auteur DV-inhoud). |
Eerste vereisten |
Inzicht krijgen in OAuth 2.0-tokenverificatie | Verificatie en autorisatie in Oracle Analytics Cloud worden beheerd door Oracle Identity Cloud Service. Als u toegang wilt tot de Oracle Analytics Cloud REST-API's, hebt u een OAuth 2.0-toegangstoken nodig voor autorisatie. | OAuth 2.0-tokenverificatie |
Ondersteunde gegevensbronnen begrijpen | Lees het onderwerp waarin de soorten gegevensverbindingen worden beschreven die u met REST-API's kunt beheren. | Ondersteunde gegevensbronnen |
JSON-payloadindelingen beheren | Lees het onderwerp waarin de JSON-payloadindeling voor uw gegevensbron wordt beschreven en verkrijg de vereiste verbindingsparameters. | Voorbeelden van JSON-payloads voor gegevensbronnen |
Een verbinding maken | Maak een gegevensverbinding voor gebruik in werkmappen, rapporten en dashboards. | Een verbinding maken (voorbeeld) |
Een verbinding bijwerken | Werk een of meer eigenschappen van een bestaande gegevensverbinding bij. | Een verbinding bijwerken (voorbeeld) |
Een verbinding verwijderen | Een gegevensverbinding verwijderen. | Een verbinding verwijderen (voorbeeld) |
Met deze voorbeelden kunt u met behulp van cURL gegevensbronverbindingen beheren met REST-API-aanvragen.
Voorbeeld cURL-opmaak
curl --header "Authorization: Bearer <token>" --header "Content-Type: application/json" --request POST|PUT https://<hostname>/api/20210901/catalog/connections --data "<data source connection payload>"
curl --header "Authorization: Bearer <token>" --request POST|PUT https://<hostname>/api/20210901/catalog/connections --form "cert=<security wallet file>" --form "connectionParams=<data source connection payload>"
<token>: OAuth 2.0-dragertoken vereist om aanroepen naar REST-API's van Oracle Analytics Cloud te verifiëren. Zie voor meer informatie: OAuth 2.0-tokenverificatie.
<hostnaam>: host waarop Oracle Analytics Cloud wordt uitgevoerd.
<payload gegevensbronverbinding>: gegevensbronspecifieke verbindingsgegevens. Zie voor meer informatie: Voorbeelden van JSON-payloads voor gegevensbronnen.
<walletbestand beveiliging>: slaat SSL-gerelateerde informatie op, zoals authenticatie- en ondertekeningsreferenties, privésleutels, certificaten en vertrouwde certificaten. Vereist voor sommige verbindingssoorten, zoals Oracle Database met SSL en Oracle Autonomous Data Warehouse (wederzijdse TLS).
Voorbeelden
In de volgende voorbeelden wordt getoond hoe een verbinding met Oracle Autonomous Data Warehouse (ADW) te maken.
cwallet.sso
(wederzijdse TLS)Opmerking:
De JSON-payloads in deze voorbeelden zijn specifiek voor Oracle ADW. De JSON-payloadindeling is anders voor andere gegevensbronnen. Zie Voorbeelden van JSON-payloads voor ondersteunde gegevensbronnen.Voorbeeld 1: een verbinding zonder wallet (TLS) maken met Oracle ADW
oracle_adw_walletless
. De aanvraagtekst bevat een eenvoudige JSON (application/json
).
curl --header "Authorization: Bearer <token>" --header "Content-Type: application/json" --request POST https://example.com/api/20210901/catalog/connections --data "{ "version": "2.0.0", "type": "connection", "name": "oracle_adw_walletless", "description": "Sample Oracle ADW connection without a wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_adwwalletless_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))", "username": "ADMIN", "password": "<<password>>", "systemConnection": false, "remoteData": false, "sslType": "ServerSideSSL" } } }"
Responstekst
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Maak een notitie van de Base64-gecodeerde connectionId
in de antwoordtekst. U kunt deze waarde later gebruiken om de verbinding bij te werken of te verwijderen.
Voorbeeld 2: een verbinding met Oracle ADW maken waarbij wordt gebruikgemaakt van een walletbestand (wederzijdse TLS)
oracle_adw_with_wallet
. De aanvraagtekst bevat meerdelig/formuliergegevens
, wat wil zeggen dat er zowel een walletbestand van Oracle ADW (cwallet.sso
) als Oracle ADW verbindingsparameters nodig zijn.
curl --header "Authorization: Bearer <token>" -–request POST https://<hostname>/api/20210901/catalog/connections --form "cert=@"/Users/scott/Downloads/Wallet_adw/cwallet.sso"" --form "connectionParams= "{ "version": "2.0.0", "type": "connection", "name": "oracle_adw_with_wallet", "description": "Sample Oracle ADW connection with a wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_walletadw_high.adwc.oraclecloud.com/))(security=(ssl_server_dn_match=yes)))", "username": "ADMIN", "password": "<<password>>", "remoteData": "false", "systemConnection": false, "sslType": "ClientSideSSL" } } }"
Responstekst
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Maak een notitie van de Base64-gecodeerde connectionId
in de antwoordtekst. U kunt deze waarde later gebruiken om de verbinding bij te werken of te verwijderen.
Aanvullende voorbeelden zijn beschikbaar in de REST-API voor Oracle Analytics Cloud. Zie Een verbinding maken, Een verbinding bijwerken en Een verbinding verwijderen.
Om verbinding te maken met een gegevensbron, moet u verbindingsparameters opgeven. Wanneer u de REST-API voor verbindingen gebruikt, geeft u verbindingsparameters in een JSON-payload-indeling. Gebruik deze tabel om de JSON-payload te bepalen voor de gegevensbron waarmee u verbinding wilt maken.
Gegevensbron | Aanvraagsoort | Invoerpayload |
---|---|---|
Oracle Database (Niet-SSL) |
applicatie/json |
Basisverbindingssoort { "version": "2.0.0", "type": "connection", "name": "oracle_db_non_ssl_basic", "description": "Sample non-SSL Oracle Database connection created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-database", "host": "example.com", "port": "1521", "serviceName": "orcl", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } Geavanceerde verbindingssoort { "version": "2.0.0", "type": "connection", "name": "oracle_db_non_ssl_advanced ", "description": " Sample non-SSL Oracle Database connection created with the advanced connection string format using Connections API", "content": { "connectionParams": { "connectionString": "(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=example.com)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)))", "username": "admin", "password": "<password>", "connectionType": "oracle-database", "remoteData": false, "systemConnection": false } } } |
Oracle Database met SSL |
meerdelig/formuliergegevens |
cwallet.sso (client credentials file) Basisverbindingssoort cert: <cwallet.sso file location> connectionParams: { "version": "2.0.0", "type": "connection", "name": "oracle_db_ssl", "description": "Sample Oracle Database connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-database", "host": "example.com", "port": "2484", "serviceName": "ORCLPDB1", "username": "admin", "password": "<password>", "systemConnection": false, "remoteData": false } } } |
Oracle Autonomous Data Warehouse: zonder wallet (TLS) |
applicatie/json |
Basisverbindingssoort { "version": "2.0.0", "type": "connection", "name": "oracle_adw_walletless_basic", "description": "Sample Oracle ADW connection without a wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521) (host=example.com)) (connect_data=(service_name=example.com)) (security=(ssl_server_dn_match=yes)))", "username": "admin", "password": "<password>", "systemConnection": false, "remoteData": false, "sslType": "ServerSideSSL" } } } |
Oracle Autonomous Data Warehouse: wallet (TLS) |
meerdelig/formuliergegevens |
cwallet.sso (client credentials file) Basisverbindingssoort cert: <cwallet.sso file location> connectionParams: { "version": "2.0.0", "type": "connection", "name": "oracle_adw_with_wallet", "description": "Sample Oracle ADW connection with wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=example.com)) (connect_data=(service_name=example.com)) (security=(ssl_server_dn_match=yes)))", "username": "admin", "password": "<password>", "remoteData": "false", "systemConnection": false, "sslType": "ClientSideSSL" } } } |
PostgreSQL (Niet-SSL) |
applicatie/json |
Basisverbindingssoort { "version":"2.0.0", "type": "connection", "name": "postgres_non_SSL", "description": "Sample PostgreSQL connection created using Connections API", "content": { "connectionParams": { "connectionType": "postgresql-database", "host": "example.com", "port": "5432", "serviceName": "postgres", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
PostgreSQL met SSL |
applicatie/json |
Basisverbindingssoort { "version":"2.0.0", "type": "connection", "name": "postgres_SSL_Conn", "description": "Sample PostgreSQL connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "postgresql-database", "host": "example.com", "port": "5432", "serviceName": "postgres", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
SQL Server (Niet-SSL) |
applicatie/json |
Basisverbindingssoort { "version":"2.0.0", "type": "connection", "name": "SqlServer_non_ssl", "description": "Sample non-SSL SQL Server connection created using Connections API", "content": { "connectionParams": { "connectionType": "sqlserver-database", "host": "example.com", "port": "1400", "serviceName": "sqlserver1", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
SQL Server met SSL | applicatie/json |
Basisverbindingssoort { "version":"2.0.0", "type": "connection", "name": "SqlServer_ssl", "description": "Sample SQL Server connection with SSL created using the Connections API", "content": { "connectionParams": { "connectionType": "sqlserver-database", "host": "example.com", "port": "60190", "serviceName": "sqlserver1", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
MySQL (Niet-SSL) |
applicatie/json |
Basisverbindingssoort { "version":"2.0.0", "type": "connection", "name": "MySql_no_SSL", "description": "Sample MySQL connection created using the Connections API", "content": { "connectionParams": { "connectionType": "mysql-database", "host": "example.com", "port": "3307", "serviceName": "mysql1", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
MySQL met SSL | applicatie/json |
Basisverbindingssoort { "version":"2.0.0", "type": "connection", "name": "MySql_ssl", "description": "Sample MySQL connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "mysql-database", "host": "example.com", "port": "3306", "serviceName": "mysql1", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
Oracle Essbase |
applicatie/json |
Basisverbindingssoort { "version":"2.0.0", "type": "connection", "name": "Oracle_Essbase", "description": "Sample Oracle Essbase connection created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-essbase", "dsn":"example.com", "username":"admin", "password":"<password>", "remoteData": false, "systemConnection": false, "authentication":"current"/"private"/"sso" } } } |