Sie können Verbindungen zu Datenquellen erstellen, aktualisieren, entfernen und teilen. Als Oracle Analytics-Benutzer mit Zugriff eines DV Content Authors können Sie die folgenden Aktionen ausführen.
Themen:
Sie können eine Verbindung erstellen, damit Sie die Daten in dieser Datenquelle analysieren können.
Sie können die Verbindungsdetails einer Datenquelle aktualisieren.
Wenn Sie eine SSL-Verbindung zu einer Oracle-Datenbank bearbeiten und eine neue Datei cwallet.sso
verwenden müssen, klicken Sie im Feld Client-Wallet auf Auswählen, und navigieren Sie zur Datei cwallet.sso
. Fragen Sie den Administrator nach dem Speicherort der Datei cwallet.sso
.
Sie können eine Datenquellenverbindung aus Oracle Analytics Cloud entfernen. Beispiel: Sie müssen eine Datenbankverbindung löschen und eine neue Verbindung erstellen, wenn das Datenbankkennwort geändert wurde.
Wenn die Verbindung Datasets enthält, müssen Sie die Datasets löschen, bevor Sie die Verbindung löschen können.
Sie können Zugriffsberechtigungen für die von Ihnen erstellten oder verwalteten Datenquellenverbindungen zuweisen.
Wenn Sie Verbindungsdetails im Dialogfeld "Verbindung erstellen" oder Dialogfeld "Prüfen" angeben, stehen für einige Datenbanktypen zusätzliche Konfigurationsoptionen zur Verfügung.
Allgemeine Optionen
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)))
Bulkreplikation aktivieren: Wenn Sie ein Dataset für eine Arbeitsmappe laden, sollte diese Option deaktiviert sein. Sie können sie dann ignorieren. Diese Option ist für Datenanalysten und erfahrene Benutzer reserviert, um Daten aus einer Datenbank in eine andere zu replizieren.
Authentifizierungsoptionen
Systemverbindung
Klicken Sie auf Kopieren, um die Objekt-ID der Verbindung zu kopieren. Business Modeler können die Objekt-ID einfügen, um eine Datenverbindung in Model Administration Tool (Dialogfeld "Verbindungspool") zu identifizieren und zu verwenden.
Hinweis: Wenn Sie beim anfänglichen Erstellen der Verbindung nicht auf Systemverbindung klicken und später möchten, dass die Verbindungsdetails von Datenmodellierern verwendet werden können, müssen Sie eine neue Verbindung erstellen und dabei Systemverbindung auswählen. Sie können die Verbindung also nicht nachträglich bearbeiten und diese Option auswählen.
Machen Sie sich vor dem Erstellen der Datenbankverbindung mit den Anforderungen für Datenbankverbindungen vertraut.
Die maximale Anzahl der in Oracle Analytics angezeigten Datenbanktabellen beträgt 10.000. Wenn Sie zusätzliche Tabellen benötigen, empfiehlt Oracle, dass Sie den Datenbankadministrator bitten, einen Datenbankbenutzer mit Zugriff auf die jeweiligen zu analysierenden Objekte zu erstellen. Anschließend müssen Sie beim Erstellen der Datenbankverbindung die Zugangsdaten dieses Benutzers angeben.
Wenn Sie eine Verbindung zu einer Oracle-Datenbank, zu Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL Server oder My SQL herstellen, können Sie den Standard-Begrenzer für Bezeichner ändern, damit Sie Daten in Großbuchstaben, Kleinbuchstaben oder gemischter Groß-/Kleinschreibung in Tabellen- oder Spaltenamen lesen können.
select "EfG_Field" from "AbCd";
doppelte Anführungszeichen hinzu, anstatt select EfG_Field from AbCd;
auszugeben (diese Anweisung würde nicht erfolgreich verlaufen).Sie können Oracle Analytics Cloud-REST-APIs verwenden, um Verbindungen zu zahlreichen Datenquellen programmgesteuert zu verwalten. Beispiel: Möglicherweise möchten Sie ein Skript erstellen, das dieselben Verbindungen in Ihren Test- und Produktionsumgebungen von Oracle Analytics Cloud erstellt (oder ändert).
Sie können Verbindungen für verschiedene Datenquellen mit REST-APIs erstellen, aktualisieren und löschen. In diesem Thema werden die Typen von Datenquellenverbindungen aufgelistet, die Sie mit REST-APIs verwalten können.
Hinweis:
REST-API für Oracle Analytics Cloud enthält detaillierte Informationen zu den einzelnen REST-APIs. Siehe Verbindungs-REST-Endpunkte.Unterstützte Datenquellen
Verbindungsparameter
Für jede Datenquelle sind andere Verbindungsparameter erforderlich. Wenn Sie die REST-API zum Erstellen oder Aktualisieren einer Verbindung verwenden möchten, müssen Sie das richtige JSON-Payload-Format für die Datenquelle nutzen. Siehe Beispiel-JSON-Payloads für Datenquellen.
Hier finden Sie die gängigen Aufgaben zum programmgesteuerten Verwalten von Verbindungen mit Oracle Analytics Cloud-REST-APIs. Wenn Sie die REST-APIs zum ersten Mal verwenden, führen Sie die folgenden Aufgaben aus.
Aufgabe | Beschreibung | REST-API-Dokumentation |
---|---|---|
Hinweise zu Voraussetzungen |
Finden Sie heraus, welche Aufgaben vorab erforderlich sind, und führen Sie sie aus. Sie müssen Berechtigungen zum Erstellen von Arbeitsmappen und Verbinden mit Daten in Oracle Analytics Cloud besitzen, um Datenverbindungen mit REST-APIs zu verwalten (DV Content Author). |
Voraussetzungen |
OAuth 2.0-Tokenauthentifizierung verstehen | Authentifizierung und Autorisierung in Oracle Analytics Cloud werden mit Oracle Identity Cloud Service verwaltet. Für den Zugriff auf die Oracle Analytics Cloud-REST-APIs benötigen Sie ein OAuth 2.0-Zugriffstoken für die Autorisierung. | OAuth 2.0-Tokenauthentifizierung |
Unterstützte Datenquellen verstehen | Lesen Sie das Thema, in dem die Typen von Datenverbindungen beschrieben werden, die Sie mit REST-APIs verwalten können. | Unterstützte Datenquellen |
JSON-Payload-Formate bestimmen | Lesen Sie das Thema, in dem die JSON-Payload-Formate für Ihre Datenquelle beschrieben werden, und rufen Sie die erforderlichen Verbindungsparameter ab. | Beispiel-JSON-Payloads für Datenquellen |
Verbindung erstellen | Erstellen Sie eine Datenverbindung, die in Arbeitsmappen, Berichten und Dashboards verwendet werden kann. | Verbindung erstellen (Vorschau) |
Verbindung aktualisieren | Aktualisieren Sie Eigenschaften einer vorhandenen Datenverbindung. | Verbindung aktualisieren (Vorschau) |
Verbindung löschen | Löschen Sie eine Datenverbindung. | Verbindung löschen (Vorschau) |
Anhand der folgenden Beispiele wird gezeigt, wie Sie Datenquellenverbindungen mit REST-API-Anforderungen über cURL verwalten.
cURL-Beispielformat
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-Bearer-Token, das zum Authentifizieren von Aufrufen an Oracle Analytics Cloud-REST-APIs erforderlich ist. Siehe OAuth 2.0-Tokenauthentifizierung.
<hostname>: Host, auf dem Oracle Analytics Cloud ausgeführt wird.
<data source connection payload>: Datenquellenspezifische Verbindungsinformationen. Siehe Beispiel-JSON-Payloads für Datenquellen.
<security wallet file>: Speichert SSL-bezogene Informationen, wie Authentifizierungs- und Anmeldedaten, Private Keys, Zertifikate und vertrauenswürdige Zertifikate. Für einige Verbindungstypen erforderlich, wie Oracle Database mit SSL und Oracle Autonomous Data Warehouse (gegenseitige TLS).
Beispiele
In den folgenden Beispielen wird gezeigt, wie Sie eine Verbindung zu Oracle Autonomous Data Warehouse (ADW) erstellen.
cwallet.sso
verwendet (gegenseitige TLS)Weitere Beispiele sind in REST-API für Oracle Analytics Cloud verfügbar. Siehe Verbindung erstellen (Vorschau), Verbindung aktualisieren (Vorschau) und Verbindung löschen (Vorschau).
Hinweis:
Die JSON-Payloads in diesen Beispielen gelten speziell für Oracle ADW. Bei anderen Datenquellen wird ein anderes JSON-Payload-Format verwendet. Siehe Beispiel-JSON-Payloads für unterstützte Datenquellen.
Beispiel 1: Verbindung ohne Wallet (TLS) zu Oracle ADW erstellen
oracle_adw_walletless
. Der Anforderungsbody enthält einfache 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" } } }"
Antwortbody
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Notieren Sie sich die Base64-codierte connectionId
im Antwortbody. Mit diesem Wert können Sie die Verbindung später aktualisieren oder löschen.
Beispiel 2: Verbindung zu Oracle ADW erstellen, die eine Wallet-Datei verwendet (gegenseitige TLS)
oracle_adw_with_wallet
. Der Anforderungsbody enthält multipart/form-data
, das heißt, sowohl eine Wallet-Datei von Oracle ADW (cwallet.sso
) als auch Oracle ADW-Verbindungsparameter sind erforderlich.
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" } } }"
Antwortbody
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Notieren Sie sich die Base64-codierte connectionId
im Antwortbody. Mit diesem Wert können Sie die Verbindung später aktualisieren oder löschen.
Um eine Verbindung zu einer Datenquelle herzustellen, geben Sie Verbindungsparameter an. Wenn Sie die Verbindungs-REST-API verwenden, geben Sie Verbindungsparameter in einem JSON-Payload-Format an. Anhand dieser Tabelle können Sie die JSON-Payload für die gewünschte Datenquelle bestimmen.
Datenquelle | Anforderungstyp | Eingabe-Payload |
---|---|---|
Oracle Database (Nicht-SSL) |
application/json |
Einfacher Verbindungstyp { "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 } } } Erweiterter Verbindungstyp { "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 mit SSL |
multi-part/form-data |
cwallet.sso (client credentials file) Einfacher Verbindungstyp 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 - ohne Wallet (TLS) |
application/json |
Einfacher Verbindungstyp { "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 (gegenseitige TLS) |
multipart/form-data |
cwallet.sso (client credentials file) Einfacher Verbindungstyp 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 (Nicht-SSL) |
application/json |
Einfacher Verbindungstyp { "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 mit SSL |
application/json |
Einfacher Verbindungstyp { "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 (Nicht-SSL) |
application/json |
Einfacher Verbindungstyp { "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 mit SSL | application/json |
Einfacher Verbindungstyp { "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 (Nicht-SSL) |
application/json |
Einfacher Verbindungstyp { "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 mit SSL | application/json |
Einfacher Verbindungstyp { "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 |
Einfacher Verbindungstyp { "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" } } } |