Du kan skapa, uppdatera, ta bort och dela anslutningar till datakällor. Som användare av Oracle Analytics med åtkomsten DV-innehållskonstruktör kan du utföra dessa åtgärder.
Avsnitt:
Du kan skapa en anslutning som gör att du kan analysera data i den datakällan.
Du kan uppdatera en datakällas anslutningsdetaljer.
Om du redigerar en SSL-anslutning till en Oracle-databas och du måste använda en ny cwallet.sso
-fil klickar du på Välj i fältet Klientplånbok och bläddrar efter filen cwallet.sso
. Fråga administratören var du kan hitta filen cwallet.sso
.
Du kan ta bort en datakällanslutning från Oracles analysmoln. Du måste till exempel ta bort en databasanslutning och skapa en ny anslutning när lösenordet för databasen har ändrats.
Om anslutningen innehåller några datamängder måste du ta bort datamängderna innan du kan ta bort anslutningen.
Du kan tilldela åtkomstbehörigheter för datakällsanslutningarna du skapar eller administrerar.
När du anger anslutningsdetaljer i dialogrutan Skapa anslutning eller Inspektera finns det extra konfigurationsalternativ för vissa typer av databaser.
Generella alternativ
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)))
Aktivera massreplikering – om du laddar en datamängd för en arbetsbok ska det här alternativet vara avaktiverat och du kan ignorera det. Det här alternativet är reserverat för att dataanalytiker och avancerade användare ska kunna replikera data från en databas till en annan.
Autentiseringsalternativ
Systemanslutning
Klicka på Kopiera och kopiera anslutningens Objekt-id. Affärsmodellerare kan klistra in ett Objekt-id för att identifiera och använda en dataanslutning i modelladministrationsverktyget (dialogrutan Anslutningspool).
Obs! Om du inte klickar på Systemanslutning när du skapar anslutningen och senare vill att datamodellerare ska använda anslutningsdetaljerna måste du skapa en ny anslutning och välja Systemanslutning. Du kan med andra ord inte redigera anslutningen och välja det alternativet senare.
Se till att förstå kraven för databasanslutning innan du skapar databasanslutningen.
Det högsta antal databastabeller som kan visas i Oracle Analytics är 10 000. Om du behöver fler tabeller rekommenderar Oracle att du ber databasadministratören att skapa en databasanvändare med åtkomst till de specifika objekt du vill analysera och anger den användarens inloggningsuppgifter när du skapar databasanslutningen.
Om du ansluter till en Oracle-databas, Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL Server eller My SQL kan du ändra den standardinställda identifieraren för citattecken så att du kan läsa data i versaler, gemener eller både versaler och gemener i namn på tabeller eller kolumner.
select "EfG_Field" from "AbCd";
i stället för att utfärda select EfG_Field from AbCd;
(vilket inte skulle utföras).Du kan använda Oracles analysmolns REST-API:er till att hantera anslutningar till ett flertal olika datakällor programstyrt. Du kanske till exempel vill skapa ett skript som skapar (eller ändrar) samma uppsättning anslutningar i test- och produktionsmiljön i Oracles analysmoln .
Du kan skapa, uppdatera och ta bort anslutningar till ett flertal olika datakällor som använder REST-API:er. I det här avsnittet listas de typer av anslutningar till datakällor som du kan hantera med REST-API:er.
Obs!:
I REST-API för Oracles analysmoln hittar du detaljerad information om varje REST-API. Se REST-slutpunkter för anslutningar.Datakällor som stöds
Anslutningsparametrar
De olika datakällorna kräver olika anslutningsparametrar. Om du vill använda REST-API:t till att skapa eller uppdatera en anslutning måste du känna till det format för JSON-nyttolast som krävs för datakällan. Se Exempel på JSON-nyttolaster för datakällor.
Här är de vanliga uppgifterna för att börja använda Oracles analysmolns REST-API:er för att hantera anslutningar programstyrt. Om det är första gången du använder REST-API:erna kan du följa dessa steg.
Uppgift | Beskrivning | Dokumentation för REST-API:er |
---|---|---|
Förstå förutsättningarna |
Förstå och slutför flera förutsättningsuppgifter. Du måste ha behörighet att skapa arbetsböcker och ansluta till data i Oracles analysmoln för att hantera dataanslutningar med REST-API:er (DV-innehållskonstruktör). |
Förutsättningar |
Förstå autentisering med OAuth 2.0-token | Autentisering och auktorisering i Oracles analysmoln hanteras via Oracles molntjänst för identiteter. För åtkomst till Oracles analysmolns REST-API:er behöver du en OAuth 2.0-åtkomsttoken för auktorisering. | Autentisering med OAuth 2.0-token |
Om datakällor som stöds | Läs det avsnitt som beskriver de typer av dataanslutningar du kan hantera med REST-API:er. | Datakällor som stöds |
Fastställa JSON-nyttolasternas format | Läs avsnittet som beskriver formatet för JSON-nyttolast för datakällan och erhåll de anslutningsparametrar som krävs. | Exempel på JSON-nyttolaster för datakällor |
Skapa en anslutning | Skapa en dataanslutning som ska användas i arbetsböcker, rapporter och infopaneler. | Skapa en anslutning (förhandsvisning) |
Uppdatera en anslutning | Uppdatera en eller flera egenskaper för en befintlig dataanslutning. | Uppdatera en anslutning (förhandsvisning) |
Ta bort en anslutning | Ta bort en dataanslutning. | Ta bort en anslutning (förhandsvisning) |
Med dessa exempel kan du hantera datakällsanslutningar med REST-API-begäranden med hjälp av cURL.
Exempel på format för 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> – OAuth 2.0-innehavartoken som krävs för autentisering av anrop till Oracles analysmolns REST-API:er. Se Autentisering med OAuth 2.0-token.
<hostname> – värden hos vilken Oracles analysmoln körs.
<data source connection payload> – anslutningsinformation specifik för datakällan. Se Exempel på JSON-nyttolaster för datakällor.
<security wallet file> – lagrar SSL-relaterad information som autentiseringsuppgifter, signeringsuppgifter, privata nycklar, certifikat och betrott certifikat. Krävs för vissa anslutningstyper, t.ex. Oracle Database med SSL och Oracle Autonomous Data Warehouse (ömsesidig TLS).
Exempel
Följande exempel visar hur du skapar en anslutning till Oracle Autonomous Data Warehouse (ADW).
cwallet.sso
(ömsesidig TLS)Fler exempel finns i REST-API för Oracles analysmoln. Se Skapa en anslutning (förhandsvisning), Uppdatera en anslutning (förhandsvisning) och Ta bort en anslutning (förhandsvisning).
Obs!:
JSON-nyttolasterna i de här exemplen gäller specifikt för Oracle ADW. JSON-nyttolasternas format är annorlunda för andra datakällor. Se Exempel på JSON-nyttolaster för datakällor som stöds.
Exempel 1: skapa en plånboksfri (TLS) anslutning till Oracle ADW
oracle_adw_walletless
. Begärans textdel innehåller 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" } } }"
Svarstext
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Anteckna det Base64-kodade värdet för connectionId
i svarstexten. Senare kan du använda det värdet till att uppdatera eller ta bort anslutningen.
Exempel 2: skapa en anslutning till Oracle ADW som använder en plånboksfil (ömsesidig TLS)
oracle_adw_with_wallet
. Begärans textdel innehåller multipart/form-data
, vilket innebär att det krävs en plånboksfil från Oracle ADW (cwallet.sso
) och anslutningsparametrar för 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" } } }"
Svarstext
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Anteckna det Base64-kodade värdet för connectionId
i svarstexten. Senare kan du använda det värdet till att uppdatera eller ta bort anslutningen.
Om du vill ansluta till en datakälla måste du ange anslutningsparametrar. När du använder anslutnings-REST-API:t anger du anslutningsparametrar i ett format för JSON-nyttolaster. Använd den här tabellen till att fastställa JSON-nyttolasten för den datakälla du vill ansluta till.
Datakälla | Typ av begäran | Indatanyttolast |
---|---|---|
Oracle Database (Utan SSL) |
application/json |
Grundläggande anslutningstyp { "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 } } } Avancerad anslutningstyp { "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 |
multi-part/form-data |
cwallet.sso (client credentials file) Grundläggande anslutningstyp 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 – utan plånbok (TLS) |
application/json |
Grundläggande anslutningstyp { "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 – plånbok (ömsesidig TLS) |
multipart/form-data |
cwallet.sso (client credentials file) Grundläggande anslutningstyp 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 (Utan SSL) |
application/json |
Grundläggande anslutningstyp { "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 |
Grundläggande anslutningstyp { "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 (Utan SSL) |
application/json |
Grundläggande anslutningstyp { "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 |
Grundläggande anslutningstyp { "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 (Utan SSL) |
application/json |
Grundläggande anslutningstyp { "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 |
Grundläggande anslutningstyp { "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 |
Grundläggande anslutningstyp { "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" } } } |