Možete stvoriti, ažurirati, ukloniti i dijeliti veze s izvorima podataka. Te radnje možete izvršiti kao korisnik servisa Oracle Analytics s pristupom autora DV sadržaja.
Teme:
Možete stvoriti vezu koja će vam omogućiti da analizirate podatke u tom izvoru podataka.
Možete ažurirati pojedinosti veze izvora podataka.
Ako uređujete SSL vezu sa servisom Oracle Database i trebate upotrijebiti novu datoteku cwallet.sso
, u polju Sigurnosni podaci walleta pritisnite Odaberi kako biste pronašli datoteku cwallet.sso
. Od administratora zatražite lokaciju datoteke cwallet.sso
.
Vezu s izvorom podataka možete ukloniti iz servisa Oracle Analytics Cloud. Na primjer, vezu s bazom podataka morate izbrisati i stvoriti novu ako je promijenjena lozinka baze podataka.
Ako veza sadrži izvore podataka, prije brisanja veze morate izbrisati izvore podataka.
Dopuštenja za pristup možete dodijeliti vezama s izvorom podataka koje ste stvorili ili administrirali.
Nakon što definirate pojedinosti veze u dijaloškom okviru Stvaranje veze ili Provjera, za neke vrste baza podataka otvorit će se sljedeće opcije konfiguracije.
Općenite opcije
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)))
Omogući masovnu replikaciju – Ako učitavate skup podataka za radnu knjigu, ta bi opcija trebala biti isključena i možete je zanemariti. Ova je opcija rezervirana za analitičare podataka i superkorisnike za repliciranje podataka iz jedne baze podataka u drugu bazu podataka.
Opcije za provjeru autentičnosti
Veza sustava
Pritisnite Kopiraj i kopirajte ID objekta veze. Osobe zadužene za modeliranje poslovnih podataka mogu lijepiti sadržaj u ID objekta za potrebe identificiranja i upotrebe podatkovne veze u alatu Model Administration Tool (dijaloški okvir Skup veza).
Napomena: Ako ne pritisnete Veza sustava nakon početne izrade veze, ako naknadno poželite da modelatori podataka upotrebljavaju pojedinosti veze, morat ćete izraditi novu vezu i odabrati Veza sustava. Drugim riječima, nećete moći naknadno urediti vezu i odabrati tu opciju.
Shvaća vaše zahtjeve za povezivanje s bazom podataka prije stvaranja veze s bazom podataka.
Maksimalan broj tablica baza podataka koje Oracle Analytics prikazuje iznosi 10000. Ako su vam potrebne dodatne tablice, Oracle preporučuje da od administratora baze podataka zatražite stvaranje korisnika baze podataka s pristupom konkretnim objektima koje želite analizirati uz navođenje sigurnosnih podataka tog korisnika pri stvaranju veze s bazom podataka.
Ako se povezujete s Oracle bazom podataka, Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL Server ili My SQL instancom, možete promijeniti zadani identifikator navodnika kako biste mogli očitavati podatke s velikim, malim i kombiniranim slovima u nazivima tablica/stupaca.
select "EfG_Field" from "AbCd";
umjesto da izda select EfG_Field" from "AbCd;
, (što ne bi uspjelo).Oracle Analytics Cloud REST API-je možete upotrijebiti za programsko upravljanje vezama s raznim izvorima podataka. Primjerice, možda želite izraditi skriptu koja će stvoriti (ili izmijeniti) isti skup veza u testnim i produkcijskim okruženjima Oracle Analytics Cloud.
Možete stvarati, ažurirati i brisati veze čitavog niza izvora podataka koji upotrebljavaju REST API-je. U toj temi navedene su vrste veza izvora podataka kojima možete upravljati putem REST API-ja.
Bilješka:
REST API za Oracle Analytics Cloud donosi detaljne informacije o svakom REST API-ju. Pogledajte REST krajnje točke veze.Podržani izvori podataka
Parametri veze
Parametri veze potrebni za svaki izvor podataka razlikuju se. Ako želite upotrijebiti REST API za stvaranje ili ažuriranje veze, morate znati format JSON payloada koji je neophodan za vaš izvor podataka. Pogledajte Ogledni JSON payloadi za izvore podataka.
To su uobičajeni zadaci prije početka upotrebe Oracle Analytics Cloud REST API-je za programsko upravljanje vezama. Ako po prvi put upotrebljavate REST API-je, slijedite te zadatke kao vodič.
Zadatak | Opis | Dokumentacija REST API-ja |
---|---|---|
Pojašnjenje preduvjeta |
Postoje određeni preduvjeti. Za upravljanje podatkovnim vezama putem REST API-ja (Autor DV sadržaja) morate imati dopuštenja za stvaranje radnih knjiga i povezivanje s podacima iz okruženja Oracle Analytics Cloud. |
Preduvjeti |
Pojašnjenje provjere autentičnosti OAuth 2.0 tokena | Provjerom autentičnosti i autorizacijom u servisu Oracle Analytics Cloud upravlja Oracle Identity Cloud Service. Za pristup Oracle Analytics Cloud REST API-jima trebat će vam OAuth 2.0 pristupni token za autorizaciju. | Provjera autentičnosti OAuth 2.0 tokena |
Razumijevanje podržanih izvora podataka | Pročitajte temu koja opisuje vrste podatkovnih veza kojima možete upravljati uz REST API-je. | Podržani izvori podataka |
Određivanje formata JSON payloada | Pročitajte temu koja opisuje format JSON payloada za vaš izvor podataka i pristupite traženim parametrima veze. | Ogledni JSON payloadi za izvore podataka |
Stvaranje veze | Stvaranje podatkovne veze za upotrebu u radnim knjigama, izvješćima i dashboardima. | Stvaranje veze (pregled) |
Ažuriranje veze | Ažurirajte jedno ili više svojstava postojeće podatkovne veze. | Ažuriranje veze (pregled) |
Brisanje veze | Brisanje podatkovne veze. | Brisanje veze (pregled) |
Upotrijebite ove uzorke i primjere kako biste lakše upravljali vezama izvora podataka s REST API zahtjevima upotrebom cURL-om.
Ogledni format cURL-a
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> - Token nositelja OAuth 2.0 neophodan za provjeru autentičnosti poziva prema Oracle Analytics Cloud REST API-jima. Pogledajte Provjera autentičnosti OAuth 2.0 tokena.
<hostname> - Glavno računalo na kojemu se izvodi Oracle Analytics Cloud.
<data source connection payload> - Informacije o vezi specifične za izvor podataka. Pogledajte Ogledni JSON payloadi za izvore podataka.
<security wallet file> - Spremanje SSL informacija, uključujući sigurnosne podatke za provjeru autentičnosti i potpisivanje, privatne ključeve, certifikate i pouzdane certifikate. Neophodno za određene vrste veza, uključujući Oracle bazu podataka i SSL te Oracle Autonomous Data Warehouse (zajednički TLS).
Primjeri
Sljedeći primjeri pokazuju kako stvoriti vezu za Oracle Autonomous Data Warehouse (ADW).
cwallet.sso
(zajednički TLS)Bilješka:
JSON payloadi u tim primjerima specifični su za Oracle ADW. Format JSON payloada razlikuje se za druge izvore podataka. Pogledajte Ogledni JSON payloadi za podržane izvore podataka.1. primjer: stvaranje TLS veze bez walleta za Oracle ADW
oracle_adw_walletless
. Tekst zahtjeva uključuje jednostavni 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" } } }"
Tekst odgovora
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
U tekstu odgovora zabilježite Base64 šifrirani connectionId
. Tu vrijednost naknadno možete upotrijebiti za ažuriranje ili brisanje veze.
2. primjer: stvaranje veze za Oracle ADW koja upotrebljava datoteku walleta (zajednički TLS)
oracle_adw_with_wallet
. Tekst zahtjeva uključuje multipart/form-data
, odnosno zahtijeva datoteku walleta iz okruženja Oracle ADW (cwallet.sso
) i parametre Oracle ADW veze.
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" } } }"
Tekst odgovora
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
U tekstu odgovora zabilježite Base64 šifrirani connectionId
. Tu vrijednost naknadno možete upotrijebiti za ažuriranje ili brisanje veze.
Dodatni primjeri dostupni su u dijelu REST API za Oracle Analytics Cloud. Pogledajte Stvaranje veze, Ažuriranje veze i Brisanje veze.
Za povezivanje s izvorom podataka unesite parametre veze. Ako upotrebljavate REST API veza, parametre veze navedite u formatu JSON payloada. S pomoću sljedeće tablice odredite JSON payload za izvor podataka s kojim se želite povezati.
Izvor podataka | Vrsta zahtjeva | Ulazni payload |
---|---|---|
Oracle Database (Nije SSL) |
aplikacija/json |
Osnovna vrsta veze { "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 } } } Napredna vrsta veze { "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 baza podataka i SSL |
višedijelni/podaci-obrasca |
cwallet.sso (client credentials file) Osnovna vrsta veze 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 - bez walleta (TLS) |
aplikacija/json |
Osnovna vrsta veze { "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 (zajednički TLS) |
višedijelni/podaci-obrasca |
cwallet.sso (client credentials file) Osnovna vrsta veze 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 (Nije SSL) |
aplikacija/json |
Osnovna vrsta veze { "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 i SSL |
aplikacija/json |
Osnovna vrsta veze { "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 poslužitelj (Nije SSL) |
aplikacija/json |
Osnovna vrsta veze { "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 poslužitelj i SSL | aplikacija/json |
Osnovna vrsta veze { "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 (Nije SSL) |
aplikacija/json |
Osnovna vrsta veze { "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 i SSL | aplikacija/json |
Osnovna vrsta veze { "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 |
aplikacija/json |
Osnovna vrsta veze { "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" } } } |