Du kan oprette, opdatere, fjerne og dele forbindelser til datakilder. Som Oracle Analytics-bruger med adgang som DV-indholdsforfatter kan du udføre disse handlinger.
Emner:
Du kan oprette forbindelse, så du kan analysere data i den pågældende datakilde.
Du kan opdatere forbindelsesdetaljerne for en datakilde.
Hvis du redigerer en SSL-forbindelse til en Oracle-database, og du skal bruge den nye cwallet.sso
-fil, skal du klikke på Vælg i feltet Klient-wallet for at navigere til filen cwallet.sso
. Kontakt administratoren for at få oplysninger om, hvordan du får adgang til filen cwallet.sso
.
Du kan fjerne en datakildeforbindelse fra Oracle Analytics Cloud. For eksempel skal du slette en databaseforbindelse og oprette en ny, når adgangskoden til databasen er blevet ændret.
Hvis forbindelsen indeholder datasæt, skal du slette datasættene, før du kan slette forbindelsen.
Du kan tildele adgangstilladelser til de datakildeforbindelser, som du opretter eller administrerer.
Når du angiver forbindelsesdetaljer i dialogboksen Opret forbindelse eller dialogboksen Inspicer, er der ekstra konfigurationsvalg for nogle databasetyper.
Generelle valg
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)))
Aktiver massereplikering - Hvis du indlæser et datasæt til en projektmappe, skal dette valg deaktiveres, og du kan ignorere det. Dette valg er reserveret til dataanalytikere og erfarne brugere, der skal replikere data fra én database til en anden database.
Autentificeringsvalg
Systemforbindelse
Klik på Kopier for at kopiere forbindelsens Objekt-id. Forretningsmodellører kan indsætte Objekt-id for at identificere og bruge en dataforbindelse i Model Administration Tool (dialogboksen Forbindelsespulje).
Bemærk: Hvis du ikke klikker på Systemforbindelse, når du første gang opretter forbindelsen, skal du, hvis du på et senere tidspunkt vil gøre det muligt for datamodellører at bruge forbindelsesdetaljerne, oprette en ny forbindelse og vælge Systemforbindelse. Det er med andre ord ikke muligt at redigere forbindelsen på et senere tidspunkt og angive dette valg.
Før du opretter databaseforbindelsen, skal du undersøge, hvilke krav der er til dine databaseforbindelser.
Det maksimale antal databasetabeller, der kan vises i Oracle Analytics, er 10.000. Hvis du skal bruge flere tabeller, anbefaler Oracle, at du beder databaseadministratoren om at oprette en databasebruger, der har adgang til de specifikke objekter, som du vil analysere, og at du angiver ID-oplysningerne for denne bruger, når du opretter databaseforbindelsen.
Hvis du opretter forbindelse til en Oracle-database, Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL Server eller My SQL, kan du ændre standardidentifikatoren for anførselstegn, så du kan læse data med store, små eller blandede tegn i tabel- eller kolonnenavne.
select "EfG_Field" from "AbCd";
i stedet for at udstede select EfG_Field from "AbCd;
, (som ville fejle).Du kan bruge Oracle Analytics Cloud REST-API'er til at håndtere forbindelser til en lang række datakilder via programmering. Du kan for eksempel oprette et script, som opretter (eller modificerer) det samme sæt af forbindelser i både test- og produktionsmiljøer til Oracle Analytics Cloud.
Du kan oprette, opdatere og slette forbindelser for en række datakilder ved hjælp af REST-API'er. I dette emne vises de typer af datakildeforbindelser, som du kan håndtere med REST-API'er.
Bemærk:
REST API for Oracle Analytics Cloud indeholder detaljerede oplysninger om hver REST-API. Se REST-slutpunkter for forbindelse.Understøttede datakilder
Forbindelsesparametre
De forbindelsesparametrene, der er påkrævet for hver datakilde, er forskellige. Hvis du vil bruge REST-API'en til at oprette eller opdatere en forbindelse, skal du kende det JSON-payload-format, der er påkrævet for din datakilde. Se Eksempel på JSON-payloads til datakilder.
Her er de mest almindelige opgaver til at komme i gang med at bruge Oracle Analytics Cloud REST-API'er til at håndtere forbindelser via programmering. Hvis du bruger REST-API'er for første gang, skal du bruge disse opgaver som vejledning.
Opgave | Beskrivelse | REST-API-dokumentation |
---|---|---|
Forstå forudsætninger |
Forstå og fuldfør flere indledende opgaver. Du skal have tilladelser til at oprette projektmapper og oprette forbindelse til data i Oracle Analytics Cloud for at kunne håndtere dataforbindelser ved hjælp af REST-API'er (DV-indholdsforfatter). |
Forudsætninger |
Forstå OAuth 2.0-tokenautentificering | Autentificering og autorisation i Oracle Analytics Cloud håndteres af Oracle Identity Cloud Service. For at få adgang til Oracle Analytics Cloud-REST-API'erne skal du bruge et OAuth 2.0-adgangstoken til brug for autorisation. | OAuth 2.0-tokenautentificering |
Forstå understøttede datakilder | Læs det emne, der beskriver de typer af dataforbindelser, som du kan håndtere med REST-API'er. | Understøttede datakilder |
Fastlægge JSON-payload-formater | Læs det emne, der beskriver JSON-payload-formatet til dine datakilder, og anskaf de påkrævede forbindelsesparametre. | Eksempel på JSON-payloads til datakilder |
Oprette en forbindelse | Opret en dataforbindelse til brug i projektmapper, rapporter og instrumentbrætter. | Oprette en forbindelse (prøveversion) |
Opdatere en forbindelse | Opdater en eller flere egenskaber for en eksisterende dataforbindelse. | Opdatere en forbindelse (prøveversion) |
Slette en forbindelse | Slet en dataforbindelse. | Slette en forbindelse (prøveversion) |
Brug disse eksempler som en hjælp til at håndtere datakildeforbindelser med REST-API-anmodninger ved hjælp af cURL.
Eksempel på cURL-format
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-ihændehavertoken, der kræves for at autentificere kald til Oracle Analytics Cloud REST-API'er. Se OAuth 2.0-tokenautentificering.
<hostname> - Vært, hvor Oracle Analytics Cloud kører.
<data source connection payload> - Datakildespecifikke forbindelsesoplysninger. Se Eksempel på JSON-payloads til datakilder.
<security wallet file> - Lagrer SSL-relaterede oplysninger som for eksempel legitimationsoplysninger til autentificering og signering, private nøgler, certifikater og sikkert certifikat. Påkrævet til visse forbindelsestyper, for eksempel Oracle Database med SSL og Oracle Autonomous Data Warehouse (gensidig TLS).
Eksempler
Følgende eksempler viser, hvordan du opretter en forbindelse til Oracle Autonomous Data Warehouse (ADW).
cwallet.sso
, (gensidig TLS)Yderligere eksempler er tilgængelige i REST API for Oracle Analytics Cloud. Se Oprette en forbindelse (prøveversion), Opdatere en forbindelse (prøveversion) og Slette en forbindelse (prøveversion).
Bemærk:
JSON-payloads i disse eksempler er specifikke for Oracle ADW. JSON-payload-formatet er anderledes for andre datakilder. Se Eksempel på JSON-payloads til understøttede datakilder.
Eksempel 1 Opret en wallet-løs (TLS) forbindelse til Oracle ADW
oracle_adw_walletless
. Anmodningens brødtekst inkluderer den simple 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": "Eksempel på Oracle ADW-forbindelse uden en wallet oprettet med forbindelses-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" } } }"
Responsbrødtekst
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Noter dig det Base64-kodede connectionId
i responsbrødteksten. Senere kan du bruge denne værdi til at opdatere eller slette forbindelsen.
Eksempel 2 Opret en forbindelse til Oracle ADW, som bruger en wallet-fil (gensidig TLS)
oracle_adw_with_wallet
. Anmodningsbrødteksten indeholder multipart/form-data
, som både kræver en wallet-fil fra Oracle ADW (cwallet.sso
) og Oracle ADW-forbindelsesparametre.
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": "Eksempel på Oracle ADW-forbindelse med en wallet oprettet med forbindelses-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" } } }"
Responsbrødtekst
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Noter dig det Base64-kodede connectionId
i responsbrødteksten. Senere kan du bruge denne værdi til at opdatere eller slette forbindelsen.
Du skal angive forbindelsesparametre for at oprette forbindelse til datakilde. Når du bruger forbindelses-REST API'en, skal du angive forbindelsesparametre i JSON-payload-format. Brug denne tabel til at bestemme JSON-payload for den datakilde, som du vil oprette forbindelse til.
Datakilde | Anmodningstype | Input-payload |
---|---|---|
Oracle Database (Ikke-SSL) |
application/json |
Basisforbindelsestype { "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 } } } Avanceret forbindelsestype { "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 med SSL |
multi-part/form-data |
cwallet.sso (client credentials file) Basisforbindelsestype 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 - wallet-løs (TLS) |
application/json |
Basisforbindelsestype { "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 (gensidig TLS) |
multipart/form-data |
cwallet.sso (client credentials file) Basisforbindelsestype 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 (Ikke-SSL) |
application/json |
Basisforbindelsestype { "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 med SSL |
application/json |
Basisforbindelsestype { "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 (Ikke-SSL) |
application/json |
Basisforbindelsestype { "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 med SSL | application/json |
Basisforbindelsestype { "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 (Ikke-SSL) |
application/json |
Basisforbindelsestype { "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 med SSL | application/json |
Basisforbindelsestype { "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 |
application/json |
Basisforbindelsestype { "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" } } } |