Puteţi crea, actualiza, elimina şi partaja conexiuni la sursele de date. Ca utilizator Oracle Analytics cu drepturi de acces de Autor de conţinut DV, puteţi efectua aceste acţiuni.
Subiecte:
Puteţi crea o conexiune la o sursă de date pentru a analiza datele din acea sursă de date.
Puteţi actualiza detaliile unei conexiuni la sursa de date.
Dacă editaţi o conexiune SSL la o bază de date Oracle şi trebuie să utilizaţi un nou fişier cwallet.sso
, în câmpul Wallet client, faceţi clic pe Selectare pt. a parcurge fişierul cwallet.sso
. Întrebaţi administratorul unde se află fişierul cwallet.sso
.
Puteţi elimina o conexiune la sursa de date din Oracle Analytics Cloud. Una din situaţiile când trebuie să ştergeţi o conexiune la baza de date şi să creaţi alta nouă este cea în care s-a schimbat parola bazei de date.
Când conexiunea conţine seturi de date, atunci trebuie să ştergeţi seturile de date înainte de a putea şterge conexiunea.
Puteţi să asignaţi permisiuni de acces conexiunilor la sursele de date pe care le creaţi sau administraţi.
Când specificaţi detaliile conexiunii utilizând dialogul Creare conexiune sau dialogul Inspectare, unele tipuri de baze de date au opţiuni de configurare suplimentare.
Opţiuni generale
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)))
Activare replicare în masă - Dacă încărcaţi un set de date pentru un registru de lucru, această opţiune trebuie dezactivată şi o puteţi ignora. Această opţiune este rezervată pt. analiştii de date şi utilizatorii avansaţi, pt. replicarea datelor dintr-o bază de date în alta.
Opţiuni de autentificare
Conexiune sistem
Faceţi clic pe Copiere, pentru a copia ID-ul de obiect corespunzător conexiunii. Modelatorii de business pot lipi ID-ul de obiect pentru a identifica şi utiliza o conexiune de date din Model Administration Tool (dialogul Centralizator de conexiuni).
Notă: Dacă nu faceţi clic pe Conexiune sistem atunci când creaţi pentru prima dată conexiunea, dacă mai târziu doriţi ca modelatorii de date să utilizeze detaliile conexiunii, va trebui să creaţi o conexiune nouă şi să selectaţi Conexiune sistem. Cu alte cuvinte, nu puteţi să editaţi conexiunea mai târziu şi să selectaţi această opţiune.
Înţelegeţi cerinţele pentru conexiunea dvs. la baza de date, înainte de a crea conexiunea la baza de date.
Numărul maxim al tabelelor de baze de date afişate în Oracle Analytics este de 10.000. Dacă aveţi nevoie de tabele suplimentare, Oracle vă recomandă să solicitaţi administratorului bazei de date să creeze un utilizator al bazei de date cu acces la obiectele specifice pe care doriţi să le analizaţi şi să specificaţi acreditările acelui utilizator atunci când creaţi conexiunea la baza de date.
Dacă vă conectaţi la o bază de date Oracle, Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL Server sau My SQL, puteţi modifica identificatorul de cotare prestabilit astfel încât să puteţi citi datele cu litere mari, litere mici sau cu o combinaţie de litere mari şi mici în numele de tabele sau de coloane.
select "EfG_Field" from "AbCd";
în loc să introduceţi instrucţiunea select EfG_Field" from "AbCd;
, (care ar eşua).Puteţi utiliza API-urile REST Oracle Analytics Cloud pentru a administra programatic conexiunile la o gamă de surse de date. De exemplu, puteţi dori să creaţi un script care creează (sau modifică) acelaşi set de conexiuni în mediile de producţie şi de testare Oracle Analytics Cloud.
Puteţi crea, actualiza şi şterge conexiuni pentru o gamă de surse de date folosind API-urile REST. Acest subiect listează tipurile de conexiuni la surse de date pe care le puteţi administra cu API-urile REST.
Notă:
API-ul REST pentru Oracle Analytics Cloud oferă informaţii detaliate despre fiecare API REST. ConsultaţiPuncte finale REST pentru conexiune.Surse de date acceptate
Parametri conexiune
Parametrii necesari pentru conexiune sunt diferiţi pentru fiecare sursă de date. Dacă doriţi să utilizaţi API-ul REST pentru a crea sau a actualiza o conexiune, trebuie să ştiţi care este formatul payloadului JSON necesar pentru sursa dvs. de date. Consultaţi Exemple de payloaduri JSON pentru sursele de date.
Acestea sunt sarcinile obişnuite pentru a începe să utilizaţi API-urile REST Oracle Analytics Cloud, pentru a administra programatic conexiunile. Dacă este prima dată când utilizaţi API-uri REST, urmaţi aceste sarcini drept ghid.
Sarcină | Descriere | Documentaţie API REST |
---|---|---|
Înţelegeţi cerinţele preliminare |
Înţelegeţi şi finalizaţi mai multe sarcini care reprezintă cerinţe preliminare. Pentru a administra conexiunile la date cu ajutorul API-urilor REST, trebuie să aveţi permisiuni de creare a registrelor de lucru şi de conectare la datele din Oracle Analytics Cloud (autor conţinut DV). |
Cerinţe preliminare |
Înţelegeţi autentificarea cu token OAuth 2.0 | Autentificarea şi autorizarea în Oracle Analytics Cloud sunt gestionate de Oracle Identity Cloud Service. Pentru a accesa API-urile REST Oracle Analytics Cloud, aveţi nevoie de un token de acces OAuth 2.0 pe care să îl utilizaţi pentru autorizare. | Autentificare cu token OAuth 2.0 |
Înţelegerea surselor de date acceptate | Citiţi acest subiect care descrie tipurile de conexiuni la date pe care le puteţi administra cu API-urile REST. | Surse de date acceptate |
Stabilirea formatelor pentru payloadurile JSON | Citiţi acest subiect care descrie formatele payloadurilor JSON pentru sursa dvs. de date şi obţineţi parametrii necesari ai conexiunii. | Exemple de payloaduri JSON pentru sursele de date |
Crearea unei conexiuni | Creaţi o conexiune la date pe care să o utilizaţi în registre de lucru, rapoarte şi dashboarduri. | Crearea unei conexiuni (Previzualizare) |
Actualizarea unei conexiuni | Actualizaţi una sau mai multe proprietăţi ale unei conexiuni existente la date. | Actualizarea unei conexiuni (Previzualizare) |
Ştergerea unei conexiuni | Ştergeţi o conexiune la date. | Ştergerea unei conexiuni (Previzualizare) |
Utilizaţi aceste eşantioane şi exemple pentru a vă ajuta să administraţi conexiunile la sursele de date cu cereri API REST utilizând cURL.
Exemplu de format 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> - Este necesar tokenul furnizorului OAuth 2.0 pentru a autentifica apelurile la API-urile REST Oracle Analytics Cloud. Consultaţi Autentificare cu token OAuth 2.0.
<hostname> - Gazdă unde rulează Oracle Analytics Cloud.
<data source connection payload> - Informaţii despre conexiune, specifice sursei de date. Consultaţi Exemple de payloaduri JSON pentru sursele de date.
<security wallet file> - Stochează informaţiile referitoare la SSL precum acreditările de autentificare şi de semnare, cheile private, certificatele şi certificatele securizate. Necesar pentru unele tipuri de conexiuni, precum Oracle Database cu SSL şi Oracle Autonomous Data Warehouse (TLS reciproc).
Exemple
Următoarele exemple vă arată cum să creaţi o conexiune la Oracle Autonomous Data Warehouse (ADW).
cwallet.sso
(TLS reciproc)Notă:
Payloadurile JSON din aceste exemple sunt specifice pentru Oracle ADW. Formatul payloadului JSON este diferit pentru alte surse de date. Consultaţi Exemple de payloaduri JSON pentru sursele de date acceptate.Exemplul 1 - Crearea unei conexiuni fără wallet (TLS) la Oracle ADW
oracle_adw_walletless
. Corpul cererii include JSON simplu 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" } } }"
Corp răspuns
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Reţineţi connectionId
codificat în format Base64 din corpul răspunsului. Veţi putea utiliza această valoare mai târziu pentru a actualiza sau a şterge conexiunea.
Exemplul 2 - Crearea unei conexiuni la Oracle ADW, care utilizează un fişier wallet cu acreditări (TLS reciproc)
oracle_adw_with_wallet
. Corpul cererii include multipart/form-data
, ceea ce înseamnă că necesită un fişier wallet de la Oracle ADW (cwallet.sso
) şi parametrii de conexiune ai 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" } } }"
Corp răspuns
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Reţineţi connectionId
codificat în format Base64 din corpul răspunsului. Veţi putea utiliza această valoare mai târziu pentru a actualiza sau a şterge conexiunea.
Mai multe exemple sunt disponibile în API-ul REST pentru Oracle Analytics Cloud. Consultaţi Crearea unei conexiuni, Actualizarea unei conexiuni şi Ştergerea unei conexiuni.
Pentru a vă conecta la o sursă de date, introduceţi parametrii conexiunii. Când utilizaţi API-urile REST pentru conexiuni, specificaţi parametrii conexiunii într-un format de payload JSON. Utilizaţi acest tabel pentru a stabili payloadul JSON pentru sursa de date la care vă doriţi să vă conectaţi.
Sursă de date | Tip de cerere | Payloadul de intrare |
---|---|---|
Oracle Database (Non-SSL) |
application/json |
Tip de conexiune de bază { "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 } } } Tip de conexiune avansată { "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 cu SSL |
multi-part/form-data |
cwallet.sso (client credentials file) Tip de conexiune de bază 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 - Fără wallet (TLS) |
application/json |
Tip de conexiune de bază { "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 reciproc) |
multipart/form-data |
cwallet.sso (client credentials file) Tip de conexiune de bază 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 (Non-SSL) |
application/json |
Tip de conexiune de bază { "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 cu SSL |
application/json |
Tip de conexiune de bază { "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 (Non-SSL) |
application/json |
Tip de conexiune de bază { "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 cu SSL | application/json |
Tip de conexiune de bază { "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 (Non-SSL) |
application/json |
Tip de conexiune de bază { "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 cu SSL | application/json |
Tip de conexiune de bază { "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 |
Tip de conexiune de bază { "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" } } } |