Du kan opprette, oppdatere, fjerne og dele tilkoblinger til datakilder. Du kan utføre disse handlingene som Oracle Analytics-bruker med tilgang som DV-innholdsforfatter.
Emner:
Du kan opprette en tilkobling slik at du kan analysere data i denne datakilden.
Du kan oppdatere tilkoblingsdetaljene for en datakilde.
Hvis du redigerer en SSL-tilkobling til en Oracle-database og du må bruke en ny cwallet.sso
-fil, klikker du på Velg i feltet Klientlommebok, der du kan bla til filen cwallet.sso
. Spør administratoren etter plasseringen av filen cwallet.sso
.
Du kan fjerne en datakildetilkobling fra Oracle Analytics Cloud. Du må for eksempel slette en databasetilkobling og opprette en ny tilkobling når passordet for databasen er endret.
Hvis tilkoblingen inneholder noen datakilder, må du slette datakildene før du kan slette tilkoblingen.
Du kan tilordne tilgangstillatelser til datakildetilkoblingene du oppretter eller administrerer.
Når du angir tilkoblingsdetaljer ved hjelp av dialogboksen Opprett tilkobling eller Inspiser, har enkelte databasetyper flere konfigurasjonsvalg.
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 laster et datasett for en arbeidsbok, skal dette valget være deaktivert, og du kan ignorere det. Dette valget er reservert for dataanalytikere og avanserte brukere for replikering av data fra én database til en annen.
Godkjenningsvalg
Systemtilkobling
Klikk på Kopier for å kopiere tilkoblingens objekt-ID. Forretningsmodellerere kan lime inn objekt-ID-en for å identifisere og bruke en datatilkobling i Model Administration Tool (dialogboksen Tilkoblingsreserve).
Merknad: Hvis du ikke klikker på Systemtilkobling når du oppretter tilkoblingen første gang, men senere vil at datamodellerere skal kunne bruke tilkoblingsdetaljene, må du opprette en ny tilkobling og velge Systemtilkobling. Du kan med andre ord ikke redigere tilkoblingen senere og angi dette valget.
Du må forstå kravene til databasetilkoblingen før du kan opprette databasetilkoblingen.
Maksimalt antall databasetabeller som vises i Oracle Analytics, er 10 000. Hvis du trenger flere tabeller, anbefaler Oracle at du ber databaseadministratoren om å opprette en databasebruker med tilgang til de spesifikke objektene du vil analysere, og at du angir påloggingsopplysningene for denne brukeren når du oppretter databasetilkoblingen.
Hvis du kobler til en Oracle-database, Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL Server eller MySQL, kan du endre standardidentifikatoren for anførselstegn slik at du kan lese data med store, små eller blandede bokstaver i tabell- eller kolonnenavn.
select "EfG_Field" from "AbCd";
i stedet for å utstede select EfG_Field from AbCd;
(som ville mislykkes).Du kan bruke REST-API-er for Oracle Analytics Cloud til programmatisk administrasjon av tilkoblinger til en rekke datakilder. Det kan for eksempel hende du vil opprette et skript for opprettelse (eller endring) av det samme settet med tilkoblinger i både test- og produksjonsmiljøet for Oracle Analytics Cloud.
Du kan opprette, oppdatere og slette tilkoblinger for en rekke datakilder ved hjelp av REST-API-er. Dette emnet beskriver typene datakildetilkoblinger du kan administrere med REST-API-er.
Merknad:
REST-API for Oracle Analytics Cloud inneholder detaljerte opplysninger om hvert REST-API. Se REST-sluttpunkt for tilkoblinger.Datakilder som støttes
Tilkoblingsparametre
Hvilke tilkoblingsparametre som er nødvendige for hver enkelt datakilde, varierer. Hvis du vil bruke REST-API-et til å opprette eller oppdatere en tilkobling, må du vite hvilket JSON-nyttelastformat som er nødvendig for datakilden. Se Eksempler på JSON-nyttelaster for datakilder.
Her er de vanlige oppgavene når du skal begynne å bruke REST-API-er for Oracle Analytics Cloud til å administrere tilkoblinger programmatisk. Hvis du bruker REST-API-ene for første gang, kan du bruke disse oppgavene som en veiledning.
Oppgave | Beskrivelse | Dokumentasjon for REST-API |
---|---|---|
Forstå forutsetningene |
Forstå og fullføre flere forutsetningsoppgaver. Du må ha tillatelse til å opprette arbeidsbøker og koble til data i Oracle Analytics Cloud for å kunne administrere datatilkoblinger ved hjelp av REST-API-er (innholdsforfatter for datavisualisering). |
Forutsetninger |
Forstå OAuth 2.0-symbolautentisering | Autentisering og autorisasjon i Oracle Analytics Cloud administreres av Oracle Identity Cloud Service. For at du skal få tilgang til REST-API-ene for Oracle Analytics Cloud, trenger du et OAuth 2.0-tilgangssymbol som brukes til autorisasjon. | OAuth 2.0-symbolautentisering |
Forstå datakilder som støttes | Les emnet som beskriver datatilkoblingstypene du kan administrere med REST-API-er. | Datakilder som støttes |
Fastsette JSON-nyttelastformater | Les emnet som beskriver JSON-nyttelastformatet for datakilden din, og hent de nødvendige tilkoblingsparametrene. | Eksempler på JSON-nyttelaster for datakilder |
Opprette en tilkobling | Opprett en datatilkobling for bruk i arbeidsbøker, rapporter og instrumentpaneler. | Opprette en tilkobling (forhåndsvisning) |
Oppdatere en tilkobling | Oppdater én eller flere egenskaper for en eksisterende datatilkobling. | Oppdatere en tilkobling (forhåndsvisning) |
Slette en tilkobling | Slett en datatilkobling. | Slette en tilkobling (forhåndsvisning) |
Bruk disse eksemplene som hjelp ved administrasjon av datakildetilkoblinger med REST-API-forespørsler med 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-bærersymbolet som kreves for å autentisere kall til REST-API-er for Oracle Analytics Cloud. Se OAuth 2.0-symbolautentisering.
<hostname>: Verten der Oracle Analytics Cloud kjører.
<data source connection payload>: Tilkoblingsopplysninger som er spesifikke for datakilden. Se Eksempler på JSON-nyttelaster for datakilder.
<security wallet file>: Lagrer SSL-relaterte opplysninger som påloggingsopplysninger for autentisering og signering, private nøkler, sertifikater og klarert sertifikat. Nødvendig for enkelte tilkoblingstyper, for eksempel Oracle Database med SSL og Oracle Autonomous Data Warehouse (Gjensidig TLS).
Eksempler
Eksemplene nedenfor viser hvordan du oppretter en tilkobling til Oracle Autonomous Data Warehouse (ADW).
cwallet.sso
(Gjensidig TLS)Du finner flere eksempler i REST-API for Oracle Analytics Cloud. Se Opprette en tilkobling (forhåndsvisning), Oppdatere en tilkobling (forhåndsvisning) og Slette en tilkobling (forhåndsvisning).
Merknad:
JSON-nyttelastene i disse eksemplene er spesifikke for Oracle ADW. JSON-nyttelastformatet er annerledes for andre datakilder. Se Eksempler på JSON-nyttelaster for støttede datakilder.
Eksempel 1: Opprette en tilkobling uten lommebok (TLS) til Oracle ADW
oracle_adw_walletless
. Hoveddelen av forespørselen inkluderer enkel 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" } } }"
Svarhoveddel
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Noter deg Base64-kodet connectionId
i svarhoveddelen. Du kan bruke denne verdien til å oppdatere eller slette tilkoblingen på et senere tidspunkt.
Eksempel 2: Opprette en tilkobling til Oracle ADW som bruker en lommebokfil (Gjensidig TLS)
oracle_adw_with_wallet
. Hoveddelen i forespørselen inkluderer data i flere deler/skjermbilder
. Det vil si at den krever både en lommebokfil fra Oracle ADW (cwallet.sso
) og parametre for Oracle ADW-tilkobling.
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" } } }"
Svarhoveddel
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Noter deg Base64-kodet connectionId
i svarhoveddelen. Du kan bruke denne verdien til å oppdatere eller slette tilkoblingen på et senere tidspunkt.
Du må angi tilkoblingsparametre for å kunne koble til en datakilde. Når du bruker REST-API-et for tilkoblinger, angir du tilkoblingsparametre med et bestemt JSON-nyttelastformat. Bruk denne tabellen til å bestemme JSON-nyttelasten for datakilden du vil koble til.
Datakilde | Forespørselstype | Inndatanyttelast |
---|---|---|
Oracle Database (Ikke-SSL) |
application/json |
Grunnleggende tilkoblingstype { "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 } } } Avansert tilkoblingstype { "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 |
data i flere deler/skjermbilder |
cwallet.sso (client credentials file) Grunnleggende tilkoblingstype 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 uten lommebok (TLS) |
application/json |
Grunnleggende tilkoblingstype { "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 med lommebok (Gjensidig TLS) |
data i flere deler/skjermbilder |
cwallet.sso (client credentials file) Grunnleggende tilkoblingstype 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 |
Grunnleggende tilkoblingstype { "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 |
Grunnleggende tilkoblingstype { "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 |
Grunnleggende tilkoblingstype { "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 |
Grunnleggende tilkoblingstype { "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 |
Grunnleggende tilkoblingstype { "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 |
Grunnleggende tilkoblingstype { "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 |
Grunnleggende tilkoblingstype { "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" } } } |