Auf Oracle Cloud Autonomous Data Warehouse zugreifen

Schritte für den Zugriff auf Oracle Cloud Autonomous Data Warehouse über Oracle NoSQL Database Analytics Integrator

Datenbank in Autonomous Data Warehouse erstellen

Sie müssen eine Datenbank erstellen, um von Oracle NoSQL Database Analytics Integrator auf Oracle Cloud Autonomous Data Warehouse zuzugreifen. Um eine Datenbank in Oracle Cloud Autonomous Data Warehouse zu erstellen, gehen Sie zur Oracle Cloud-Konsole, und führen Sie die folgenden Schritte aus:

Zugangsdaten für eine sichere Datenbankverbindung installieren

Verbindungen zu der Datenbank, die Sie in Autonomous Data Warehouse erstellt haben, müssen sicher sein. Damit Oracle NoSQL Database Analytics Integrator eine sichere Verbindung zur ADW-Datenbank herstellt, verwendet das Utility die Zugangsdaten, die in einem Oracle Wallet enthalten sind.

Um das Oracle Wallet abzurufen, gehen Sie zur Oracle Cloud-Konsole, und führen Sie die folgenden Schritte aus:
Die erstellte ZIP-Datei enthält folgende Elemente:
  • Die Netzwerkkonfigurationsdateien (tnsnames.ora und sqlnet.ora), die für die Verbindung zur Datenbank erforderlich sind.
  • Die automatisch offene SSO-Wallet-Datei, cwallet.SSO.
  • Die Datei PKCS12, ewallet.p12, die durch das Wallet-Kennwort geschützt ist, das Sie beim Herunterladen der ZIP-Datei über die Oracle Cloud-Konsole angegeben haben.
  • Der Java-Keystore und die Trustore-Dateien keystore.jks und truststore.jks;, die durch das Wallet-Kennwort geschützt sind.
  • Die Datei ojdbc.properties, die die Wallet-bezogene Java-Systemeigenschaft angibt, die für die Anmeldung bei der Datenbank über JDBC erforderlich ist.
  • Eine README-Datei mit Wallet-Ablaufinformationen.

Notieren Sie sich das Kennwort, nachdem Sie die Wallet-ZIP-Datei abgerufen haben, und speichern Sie das Wallet in einer beliebigen Umgebung, in der Sie sich bei der Datenbank anmelden. Um Oracle NoSQL Database Analytics Integrator verwenden zu können, muss der extrahierte Inhalt der Wallet-ZIP-Datei in der Umgebung installiert sein, in der Sie das Utility ausführen. Beispiel: Wenn Sie das Utility aus einer Oracle Cloud Compute-Instanz ausführen, sollten Sie den Inhalt der ZIP-Datei in einem beliebigen Verzeichnis auf dieser Instanz extrahieren. Verwenden Sie dann den Pfad zu diesem Verzeichnis als Wert des Parameters databaseWallet im Datenbankabschnitt der Konfigurationsdatei des Utilitys.

Resource Principal-Berechtigungsnachweise aktivieren oder Object Storage des Benutzers AUTH_TOKEN in der ADW-Datenbank speichern/aktivieren

Nachdem Sie Daten aus der gewünschten NoSQL Cloud Service-Tabelle abgerufen und diese Daten in Parquet-Dateien in Object Storage geschrieben haben, verwendet Oracle NoSQL Database Analytics Integrator Unterprogramme aus dem Oracle PL/SQL DBMS_CLOUD-Package, um die Parquet-Dateien aus Object Storage abzurufen. Anschließend werden die in diesen Dateien enthaltenen Daten in eine Tabelle in der Datenbank geladen, die Sie in Oracle Cloud Autonomous Data Warehouse erstellt haben.

Bevor Oracle NoSQL Database Analytics Integrator dies tun kann, müssen Sie der ADW-Datenbank eine Möglichkeit bieten, sich bei Object Storage für den Zugriff auf diese Parquet-Dateien zu authentifizieren. Die ADW-Datenbank kann sich auf zwei Arten beim Object Storage-Service authentifizieren: mit dem OCI-Resource Principal oder einer benutzerspezifischen AUTH_TOKEN, die Sie oder der Systemadministrator generiert. Das Authentifizierungsverfahren, das Sie verwenden möchten, wird aktiviert, indem Sie die folgenden Schritte in der Oracle Cloud-Konsole ausführen.
  • Wählen Sie im Menü auf der linken Seite der Anzeige die Option Oracle Database.
  • Wählen Sie Autonomous Database aus.

  • Wählen Sie unter Angewendete Filter das Compartment aus, in dem die Datenbank gespeichert ist.
  • Wählen Sie den Link mit dem Anzeigenamen aus, den Sie bei der Erstellung der Datenbank eingegeben haben.

  • Wählen Sie unter Database actions SQL aus.

  • Wenn Sie die ADW-Datenbank mit Object Storage mit dem Resource Principal authentifizieren möchten, führen Sie im Fenster [Arbeitsblatt]* das folgende Verfahren aus.
    EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();


    Wenn Sie die Authentifizierung mit AUTH_TOKEN ausführen möchten, die Ihnen der Systemadministrator zur Verfügung gestellt hat, oder Sie selbst generiert haben, führen Sie die Prozedur aus.

    BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL (
    credential_name => 'NOSQLADWDB_OBJ_STORE_CREDENTIAL',
    username => '<your-Oracle-Cloud-username>',
    password => '<cut-and-paste-the-AUTH_TOKEN>'
    );
    END;


Mit der Prozedur DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL kann der OCI-Resource Principal (mit dem Namen OCI$RESOURCE_PRINCIPAL) von der ADW-Datenbank bei der Authentifizierung mit einer OCI-Ressource wie Object Storage verwendet werden. Die Prozedur DBMS_CLOUD.CREATE_CREDENTIAL verschlüsselt die angegebenen AUTH_TOKEN-Zugangsdaten und speichert sie in einer Tabelle in der Datenbank mit dem Namen adwc_user. Unabhängig davon, welche Prozedur Sie verwenden, muss diese Prozedur nur einmal ausgeführt werden. Anschließend kann für alle Übertragungen von Object Storage an die ADW-Datenbank derselbe Zugangsdatenname angegeben werden.

Hinweis:

Wenn die ADW-Datenbank den OCI-Resource Principal zur Authentifizierung mit Object Storage verwendet, lautet der Name der Zugangsdaten OCI$RESOURCE_PRINCIPAL. Wenn Sie die AUTH_TOKEN zur Authentifizierung mit Object Storage verwenden, ist der Name der Zugangsdaten der Wert, den Sie für den Parameter credential_name in der Prozedur DBMS_CLOUD.CREATE_CREDENTIAL angeben. Beachten Sie jedoch, dass der oben gezeigte Wert (NOSQLADWDB_OBJ_STORE_CREDENTIAL) nur ein Beispiel ist. Sie können einen beliebigen Namen verwenden. Daher muss der Parameter dbmsCredentialName in der Konfigurationsdatei entweder den Wert OCI$RESOURCE_PRINCIPAL oder den hier angegebenen Namen für den Parameter credential_name enthalten. Dies hängt vom Authentifizierungsverfahren ab, das Sie für die Authentifizierung der ADW-Datenbank mit Object Storage verwenden.