Létrehozhat, frissíthet, eltávolíthat és megoszthat adatforrás-kapcsolatokat. DV-tartalomszerzői hozzáféréssel rendelkező Oracle Analytics-felhasználóként elvégezheti ezeket a műveleteket.
Témakörök:
Ahhoz is létrehozható kapcsolat, hogy lehetőség legyen az adott adatforrás adatait elemezni.
Módosíthatja az adatforrás kapcsolati adatait.
Ha az Oracle-adatbázishoz kapcsolódó SSL-kapcsolatot hoz létre, és új cwallet.sso
fájlra van szüksége, akkor az Ügyfél tárca mezőben kattintson a Kijelölés elemre a cwallet.sso
fájl megkereséséhez. A cwallet.sso
fájl helyéről az adminisztrátoránál tájékozódhat.
Eltávolíthat egy adatforrás-kapcsolatot az Oracle Analytics Cloud szolgáltatásból. Például Önnek törölni kell az adatbázis-kapcsolatot, és új kapcsolatot kell létrehozni, amikor megváltozik az adatbázis jelszava.
Ha a kapcsolat adatforrásokat tartalmaz, akkor az adatforrásokat a kapcsolat törlése előtt kell törölni
Hozzáférési engedélyeket azokra az adatforrás-kapcsolatokra adhat, amelyeket Ön hozott létre, vagy Ön felügyel.
Amikor kapcsolati adatokat ad meg a Kapcsolat létrehozása vagy a Kapcsolat felülvizsgálata párbeszédpanelen, egyes adatbázistípusokhoz további konfigurációs beállítások tartoznak.
Általános beállítások
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)))
Kötegelt replikáció engedélyezése - Ha egy munkafüzethez tartozó adatkészletet tölt be, ezt a beállítást ki kell kapcsolni, és figyelmen kívül hagyhatja. Ez a beállítás adatelemzők és speciális felhasználók számára van fenntartva az adatok egyik adatbázisból egy másik adatbázisba történő replikálásához.
Hitelesítési beállítások
Rendszerkapcsolat
Kattintson a Másolás elemre a kapcsolat objektumazonosítójának másolásához. Az üzleti modellezők beilleszthetik az objektumazonosítót az adatkapcsolat Model Administration Tool eszközben való azonosításához és használatához (Kapcsolatkészlet párbeszédpanel).
Megjegyzés: Ha nem kattint a Rendszerkapcsolat lehetőségre a kapcsolat létrehozásának kezdetén, és azt szeretné, hogy az adatmodellezők később használni tudják a kapcsolat részleteit, akkor létre kell hoznia egy új kapcsolatot, és ki kell választania a Rendszerkapcsolat lehetőséget. Más szóval, később nem szerkesztheti a kapcsolatot és nem válaszhatja ki ezt a lehetőséget.
Az adatbázis-kapcsolat létrehozása előtt ismerje meg az adatbázis-kapcsolatára vonatkozó követelményeket.
Az Oracle Analytics szolgáltatásban megjelenített adatbázistáblák maximális száma 10 000. Ha további táblákra van szüksége, az Oracle azt javasolja, hogy kérje meg az adatbázis rendszergazdáját, hogy hozzon létre egy olyan adatbázis-felhasználót, aki hozzáféréssel rendelkezik az Ön által elemezni kívánt konkrét objektumokhoz, és adja meg az adott felhasználó hitelesítő adatait, amikor létrehozza az adatbázis-kapcsolatot.
Ha Oracle-adatbázishoz vagy az Oracle Autonomous Data Warehouse, az Oracle Transaction Processing, a Snowflake, az SQL Server vagy a My SQL alkalmazások egyikéhez kapcsolódik, módosíthatja az alapértelmezett hivatkozási azonosítót, hogy beolvassa a nagy- és kisbetűket, valamint a kevert betűket a táblában vagy az oszlopnevekben.
select "EfG_Field" from "AbCd";
a következő helyett: select EfG_Field from AbCd;
(amely hibás lenne).Az Oracle Analytics Cloud REST API-k használatával programozással kezelheti számos adatforrás kapcsolatait. Például érdemes lehet létrehozni egy szkriptet, amely létrehozza (vagy módosítja) ugyanazt a kapcsolatkészletet az Oracle Analytics Cloud-környezetek teszt- és éles verzióiban.
Számos adatkapcsolathoz tartozó kapcsolatot létrehozhat, frissíthet és törölhet a REST API-k használatával. Ez a témakör felsorolja a REST API-kkal kezelhető adatforrás-kapcsolatok típusait.
Megjegyzés:
Az Oracle Analytics Cloud REST API-ja részletes információt biztosít az egyes REST API-król. Lásd: Kapcsolat REST-végpontjai.Támogatott adatforrások
Kapcsolati paraméterek
Az egyes adatforrásokhoz szükséges kapcsolati paraméterek különböznek. Ha kapcsolat létrehozásához vagy frissítéséhez szeretné használni a REST API-t, ismernie kell az adatforráshoz szükséges JSON-adattörzs formátumát. Lásd: Minta JSON-adattörzsek adatforrásokhoz.
Ezeknek a gyakori feladatoknak a segítségével elkezdheti használni az Oracle Analytics Cloud REST API-kat a kapcsolatok kezeléséhez programozással. Ha első alkalommal használja a REST API-kat, akkor ezen feladatok útmutatásul szolgálnak.
Feladat | Leírás | REST API-dokumentáció |
---|---|---|
Az előfeltételek megismerése |
Több előfeltételnek számító feladat megértése és elvégzése. Ahhoz, hogy adatkapcsolatokat kezelhessen REST API-k használatával, engedélyekkel kell rendelkeznie munkafüzetek létrehozásához és adatokhoz kapcsolásához az Oracle Analytics Cloud szolgáltatásban (DV tartalomkészítő). |
Előfeltételek |
Az OAuth 2.0 tokenalapú hitelesítés megismerése | Az Oracle Analytics Cloud hitelesítését és engedélyezését az Oracle Identity Cloud Service kezeli. Az Oracle Analytics Cloud REST API-jainak elérésekor OAuth 2.0 hozzáférési tokenre van szüksége az engedélyezéshez. | OAuth 2.0 tokenalapú hitelesítés |
Támogatott adatforrások megismerése | Olvassa el azt a témakört, amely leírja a REST API-k használatával kezelhető adatkapcsolatok típusait. | Támogatott adatforrások |
JSON-adattörzsek formátumának meghatározása | Olvassa el azt a témakört, amely leírja az adatforrásához kapcsolódó JSON-adattörzs formátumát, és szerezze be a szükséges kapcsolati paramétereket. | Minta JSON-adattörzsek adatforrásokhoz |
Kapcsolat létrehozása | Adatkapcsolat létrehozása munkafüzetekben, kimutatásokban és irányítópultokon való használatra. | Kapcsolat létrehozása (Előnézet) |
Kapcsolat frissítése | Egy meglévő adatkapcsolat egy vagy több tulajdonságának frissítése. | Kapcsolat frissítése (Előnézet) |
Kapcsolat törlése | Adatkapcsolat törlése. | Kapcsolat törlése (Előnézet) |
Ezek a minták és példák segítenek az adatforrás-kapcsolatok kezelésében cURL elemeket használó REST API-kérelmekkel.
Minta cURL-formátum
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 vivő token, amely az Oracle Analytics Cloud REST API-k irányába indított hívások hitelesítéséhez használatos. Lásd: OAuth 2.0 tokenalapú hitelesítés.
<hostname> – A gazdagép, amelyen az Oracle Analytics Cloud fut.
<data source connection payload> – Az adatforrásra vonatkozó kapcsolati adatok. Lásd: Minta JSON-adattörzsek adatforrásokhoz.
<security wallet file> – Az SSL-hez kapcsolódó információkat tárolja, mint a hitelesítő és aláírási hitelesítő adatokat, a személyes kulcsokat, a tanúsítványokat és a megbízható tanúsítványt. Szükséges egyes kapcsolattípusokhoz, mint az SSL-tanúsítvánnyal konfigurált Oracle adatbázishoz vagy Oracle Autonomous Data Warehouse adattárházhoz (Kölcsönös TLS).
Példák
A következő példák bemutatják, hogyan hozhatunk létre kapcsolatot az Oracle Autonomous Data Warehouse (ADW) adattárházzal.
cwallet.sso
hitelesítőadatokat tartalmazó tárcafájlt használja (Kölcsönös TLS)További példák elérhetők itt: Az Oracle Analytics Cloud REST API-ja. Lásd: Kapcsolat létrehozása (Előnézet), Kapcsolat frissítése (Előnézet) és Kapcsolat törlése (Előnézet).
Megjegyzés:
Az ezekben a példákban látható JSON-adattörzsek specifikusak az Oracle ADW adattárházra. Az összes többi adatforrás JSON-adattörzsei különböznek ezektől. Lásd: Minta JSON-adattörzsek támogatott adatforrásokhoz.
1. példa – Tárca nélküli kapcsolat (TLS) létrehozása az Oracle ADW adattárházzal
oracle_adw_walletless
nevű kapcsolatot. A kérelem szövegtörzse a következő egyszerű JSON-t tartalmazza: 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" } } }"
Válasz törzsszövege
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Jegyezze fel a Base64 kódolású connectionId
elemet a válasz szövegtörzsében. Később használhatja ezt az értéket a kapcsolat frissítéséhez vagy törléséhez.
2. példa – Olyan kapcsolat létrehozása az Oracle ADW adattárházzal, amely tárcafájlt használ (Kölcsönös TLS)
oracle_adw_with_wallet
nevű kapcsolatot. A kérelem törzsszövege tartalmazza a multipart/form-data
elemet, azaz szükség van mind egy tárcafájlra az Oracle ADW adattárházból (cwallet.sso
), mind az Oracle ADW kapcsolati paramétereire.
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" } } }"
Válasz törzsszövege
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Jegyezze fel a Base64 kódolású connectionId
elemet a válasz szövegtörzsében. Később használhatja ezt az értéket a kapcsolat frissítéséhez vagy törléséhez.
Az adatforráshoz való csatlakozáshoz meg kell adnia a csatlakozási paramétereket. A Connections REST API használatakor a kapcsolati paramétereket JSON-adattörzsformátumban adja meg. Ennek a táblának a segítségével meghatározhatja az annak az adatforrásnak megfelelő JSON-adattörzset, amelyhez kapcsolódni kíván.
Adatforrás | Kérelem típusa | Beviteli adattörzs |
---|---|---|
Oracle adatbázis (Nem SSL) |
application/json |
Alapkapcsolat típusa { "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 } } } Speciális kapcsolat típusa { "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 adatbázis SSL-lel |
multi-part/form-data |
cwallet.sso (client credentials file) Alapkapcsolat típusa 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 – Tárca nélküli (TLS) |
application/json |
Alapkapcsolat típusa { "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 – Tárcával (Kölcsönös TLS) |
multipart/form-data |
cwallet.sso (client credentials file) Alapkapcsolat típusa 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 (Nem SSL) |
application/json |
Alapkapcsolat típusa { "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 SSL-lel |
application/json |
Alapkapcsolat típusa { "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 (Nem SSL) |
application/json |
Alapkapcsolat típusa { "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 SSL-lel | application/json |
Alapkapcsolat típusa { "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 (Nem SSL) |
application/json |
Alapkapcsolat típusa { "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 SSL-lel | application/json |
Alapkapcsolat típusa { "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 |
Alapkapcsolat típusa { "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" } } } |