Pripojenia k dátovým zdrojom môžete vytvárať, aktualizovať, odoberať a zdieľať. Tieto akcie môžete vykonávať ako používateľ služby Oracle Analytics s prístupom na úrovni roly Autor obsahu DV.
Témy:
Môžete vytvoriť pripojenie, ktoré vám umožní analyzovať dáta v danom dátovom zdroji.
Detaily pripojenia dátového zdroja môžete aktualizovať.
Ak upravujete pripojenie cez SSL k databáze Oracle a potrebujete použiť nový súbor cwallet.sso
, v poli Wallet klienta kliknite na položku Vybrať a vyhľadajte súbor cwallet.sso
. Informácie o umiestnení súboru cwallet.sso
vám poskytne administrátor.
Pripojenie dátového zdroja môžete zo služby Oracle Analytics Cloud odstrániť. Databázové pripojenie je napríklad potrebné odstrániť a znova vytvoriť v prípade, že sa zmenilo heslo databázy.
Ak pripojenie obsahuje množiny dát, odstrániť ho bude možné až po odstránení týchto množín dát.
K pripojeniam dátového zdroja, ktoré ste vytvorili alebo spravujete, môžete priradiť povolenia.
Pri zadávaní detailov pripojenia pomocou dialógového okna Vytvoriť pripojenie alebo Skontrolovať sú pre niektoré typy databáz k dispozícii ďalšie voľby konfigurácie.
Všeobecné voľby
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)))
Aktivovať hromadnú replikáciu - ak zavádzate množinu dát pre zošit, táto voľba by mala byť vypnutá a môžete ju ignorovať. Uvedená voľba je rezervovaná pre analytikov dát a pokročilých používateľov, ktorí vykonávajú replikáciu dát z jednej databázy do druhej.
Voľby autentifikácie
Pripojenie systému
Kliknutím na položku Kopírovať skopírujte hodnotu ID objektu pripojenia. Biznis modelári môžu prilepiť hodnotu do poľa ID objektu na identifikáciu a používanie dátového pripojenia v nástroji Model Administration Tool (dialógové okno Spoločná oblasť pripojení).
Poznámka: ak nekliknete na položku Pripojenie systému po úvodnom vytvorení pripojenia a chcete, aby modelári dát neskôr tieto podrobnosti o pripojení používali, je potrebné, aby ste vytvorili nové pripojenie a vybrali položku Pripojenie systému. Inými slovami, upraviť pripojenie a vybrať túto voľbu už neskôr nebude možné.
Pred vytvorením databázového pripojenia by ste sa mali oboznámiť s požiadavkami na databázové pripojenie.
Maximálny počet tabuliek databázy zobrazených v službe Oracle Analytics je 10 000. Ak potrebujete ďalšie tabuľky, spoločnosť Oracle odporúča, aby ste požiadali administrátora databázy o vytvorenie používateľa databázy s prístupom ku konkrétnym objektom, ktoré chcete analyzovať, a pri vytváraní databázového pripojenia zadali doklady tohto používateľa.
Ak sa pripájate k databáze Oracle, Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL Server alebo My SQL, môžete zmeniť predvolený identifikátor používania úvodzoviek, aby ste mohli čítať dáta zapísané veľkými, malými alebo zmiešanými písmenami v názvoch tabuliek alebo stĺpcov.
select "EfG_Field" from "AbCd";
namiesto vydania príkazu select EfG_Field from AbCd;
, (ktorý by zlyhal).Pomocou rozhraní REST API služby Oracle Analytics Cloud môžete programovo spravovať pripojenia k rôznym dátovým zdrojom. Môžete napríklad vytvoriť skript, ktorý vytvorí (alebo modifikuje) rovnakú množinu pripojení v testovacom aj produkčnom prostredí služby Oracle Analytics Cloud.
Pomocou rozhraní REST API môžete vytvárať, aktualizovať a odstraňovať pripojenia pre celý rad dátových zdrojov. Táto téma uvádza typy pripojení dátových zdrojov, ktoré môžete spravovať pomocou rozhraní REST API.
Poznámka:
Podrobné informácie o jednotlivých rozhraniach REST API nájdete v príručke REST API for Oracle Analytics Cloud. Pozrite si časť Koncové body rozhraní REST pripojení.Podporované dátové zdroje
Parametre pripojenia
Parametre pripojenia vyžadované pre jednotlivé dátové zdroje sú rôzne. Ak chcete pomocou rozhrania REST API vytvoriť alebo aktualizovať pripojenie, musíte poznať formát payloadu JSON vyžadovaný pre príslušný dátový zdroj. Pozrite si časť Vzorové payloady JSON pre dátové zdroje.
Tu sú obvyklé úlohy na začatie používania rozhraní REST API služby Oracle Analytics Cloud na programované spravovanie pripojení. Ak rozhrania REST API používate prvýkrát, riaďte sa týmito úlohami.
Úloha | Popis | Dokumentácia k rozhraniam REST API |
---|---|---|
Vysvetlenie predpokladov |
Vysvetľuje a umožňuje vykonať niekoľko úloh na splnenie predpokladov. Na správu dátových pripojení pomocou rozhraní REST API sú potrebné povolenia na vytváranie zošitov a pripojenie k dátam v službe Oracle Analytics Cloud (Autor obsahu DV). |
Predpoklady |
Vysvetlenie k autentifikácii pomocou tokenu OAuth 2.0 | Autentifikáciu a autorizáciu v službe Oracle Analytics Cloud spravuje služba Oracle Identity Cloud. Ak chcete získať prístup k rozhraniam Oracle Analytics Cloud REST API, na autorizáciu potrebujete použiť prístupový token OAuth 2.0. | Autentifikácia pomocou tokenu OAuth 2.0 |
Vysvetlenie podporovaných dátových zdrojov | Prečítajte si tému, ktorá popisuje typy dátových pripojení, ktoré možno spravovať pomocou rozhraní REST API. | Podporované dátové zdroje |
Určenie formátov payloadu JSON | Prečítajte si tému, ktorá popisuje formát payloadu JSON pre váš dátový zdroj, a získajte požadované parametre pripojenia. | Vzorové payloady JSON pre dátové zdroje |
Vytvorenie pripojenia | Umožňuje vytvoriť dátové pripojenie na používanie v zošitoch, zostavách a paneloch. | Vytvorenie pripojenia (ukážka) |
Aktualizácia pripojenia | Umožňuje aktualizovať jednu alebo viaceré vlastnosti existujúceho dátového pripojenia. | Aktualizácia pripojenia (ukážka) |
Odstránenie pripojenia | Umožňuje odstrániť dátové pripojenie. | Odstránenie pripojenia (ukážka) |
Tieto vzorky a príklady vám pomôžu pri spravovaní pripojení dátových zdrojov pomocou požiadaviek rozhrania REST API s použitím príkazu cURL.
Vzorový formát príkazu cURL
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 nositeľa OAuth 2.0 potrebný na autentifikáciu volaní rozhraní REST API služby Oracle Analytics Cloud. Pozrite si časť Autentifikácia pomocou tokenu OAuth 2.0.
<hostname> – hostiteľ, v ktorom je spustená služba Oracle Analytics Cloud.
<data source connection payload> – informácie o pripojení špecifické pre dátový zdroj. Pozrite si časť Vzorové payloady JSON pre dátové zdroje.
<security wallet file> – uchováva informácie súvisiace s protokolom SSL, ako sú napríklad doklady na autentifikáciu a podpisovanie, súkromné kľúče, certifikáty a dôveryhodný certifikát. Vyžaduje sa pre niektoré typy pripojení, napríklad databáza Oracle s SSL a služba Oracle Autonomous Data Warehouse (vzájomná autentifikácia TLS).
Príklady
Nasledujúce príklady ukazujú, ako vytvoriť pripojenie k databáze Oracle Autonomous Data Warehouse (ADW).
cwallet.sso
(vzájomná autentifikácia TLS)Poznámka:
Payloady JSON v týchto príkladoch sú špecifické pre databázu Oracle ADW. Formát payloadu JSON sa líši od iných dátových zdrojov. Pozrite si časť Vzorové payloady JSON pre podporované dátové zdroje.Príklad 1 – vytvorenie pripojenia bez walletu (TLS) k databáze Oracle ADW
oracle_adw_walletless
. Telo požiadavky obsahuje jednoduchý kód 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" } } }"
Telo odpovede
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Poznačte si hodnotu connectionId
s kódovaním Base64 v tele odpovede. Neskôr môžete túto hodnotu použiť na aktualizáciu alebo odstránenie pripojenia.
Príklad 2 – vytvorenie pripojenia k databáze Oracle ADW, ktoré používa súbor walletu (vzájomná autentifikácia TLS)
oracle_adw_with_wallet
. Telo požiadavky obsahuje dáta multipart/form-data
, čo znamená, že vyžaduje súbor walletu z databázy Oracle ADW (cwallet.sso
) aj parametre pripojenia Oracle ADW.
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" } } }"
Telo odpovede
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Poznačte si hodnotu connectionId
s kódovaním Base64 v tele odpovede. Neskôr môžete túto hodnotu použiť na aktualizáciu alebo odstránenie pripojenia.
Ďalšie príklady sú k dispozícii v príručke REST API for Oracle Analytics Cloud. Pozrite si časti Vytvorenie pripojenia, Aktualizácia pripojenia a Odstránenie pripojenia.
Na pripojenie k dátovému zdroju je potrebné zadať parametre pripojenia. Ak používate rozhranie REST API Pripojenia, parametre pripojenia zadávate vo formáte payloadu JSON. Pomocou tejto tabuľky môžete určiť payload JSON pre dátový zdroj, ku ktorému sa chcete pripojiť.
Dátový zdroj | Typ požiadavky | Vstupný payload |
---|---|---|
Databáza Oracle (bez protokolu SSL) |
application/json |
Základný typ pripojenia { "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 } } } Rozšírený typ pripojenia { "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 } } } |
Databáza Oracle s protokolom SSL |
multi-part/form-data |
cwallet.sso (client credentials file) Základný typ pripojenia 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 walletu (TLS) |
application/json |
Základný typ pripojenia { "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 (vzájomná autentifikácia TLS) |
multipart/form-data |
cwallet.sso (client credentials file) Základný typ pripojenia 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 (bez protokolu SSL) |
application/json |
Základný typ pripojenia { "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 s protokolom SSL |
application/json |
Základný typ pripojenia { "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 (bez protokolu SSL) |
application/json |
Základný typ pripojenia { "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 s protokolom SSL | application/json |
Základný typ pripojenia { "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 (bez protokolu SSL) |
application/json |
Základný typ pripojenia { "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 s protokolom SSL | application/json |
Základný typ pripojenia { "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 |
Základný typ pripojenia { "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" } } } |