Externen Dateispeicher an autonome KI-Datenbank auf dedizierter Exadata-Infrastruktur anhängen

Sie können einen externen Dateispeicher, der in Oracle Cloud Infrastructure oder On Premise bereitgestellt ist, an Ihre autonome KI-Datenbank anhängen, vorausgesetzt, die Datenbank und das Dateisystem befinden sich im selben privaten Netzwerk. Die autonome KI-Datenbank auf einer dedizierten Exadata-Infrastruktur unterstützt standardmäßig NFSv4.

Auf diese Weise können Sie Daten aus OCI File Storage in Ihr virtuelles Cloud-Netzwerk (VCN) oder ein anderes Netzwerkdateisystem in On-Premise-Data Centern laden.

Die Unterstützung von externem Dateispeicher ermöglicht Folgendes:

Externe File Storage-Anforderungen

So greifen Sie vom Dateisystem aus auf Daten in einer autonomen KI-Datenbank zu:

Externes Dateisystem anhängen

Verwenden Sie DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM, um ein Dateisystem an ein Verzeichnis in Ihrer autonomen KI-Datenbank anzuhängen.

Hinweis: Die Prozedur DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM kann nur einen privaten File Storage Service an Datenbanken anhängen, die sich auf privaten Endpunkten befinden.

  1. Erstellen Sie ein Verzeichnis, oder hängen Sie das externe Dateisystem in Ihrer autonomen KI-Datenbank mit einem vorhandenen Verzeichnis an. Sie benötigen die Berechtigung WRITE für das Verzeichnisobjekt in Ihrer autonomen AI-Datenbankinstanz, um ein Dateisystem an einen Verzeichnisspeicherort in der Datenbank anzuhängen.

    Beispiel: Der folgende Befehl erstellt das Datenbankverzeichnis FSS_DIR und das Dateisystemverzeichnis fss:

    CREATE DIRECTORY FSS_DIR AS 'fss';

    Weitere Informationen finden Sie unter Directory erstellen.

  2. Führen Sie DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM aus, um ein Dateisystem an ein Verzeichnis in Ihrer autonomen KI-Datenbank anzuhängen. Um diese Prozedur ausführen zu können, müssen Sie als ADMIN-Benutzer angemeldet sein oder über die Berechtigung EXECUTE für DBMS_CLOUD_ADMIN verfügen.

    • Standardmäßig verwendet DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM NFSv3. Sie können jedoch den Parameter params explizit verwenden und nfs_version mit Wert 3 angeben, um NFSv3 anzugeben.

      BEGIN
DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name      => 'FSS',
    file_system_location  => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
    directory_name        => 'FSS_DIR',
    description           => 'Source FSS for sales data'
);END;
/

    • Um NFSv4 zu verwenden, nehmen Sie den Parameter params mit DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM auf, und geben Sie den Wert nfs_version mit dem Wert 4 an, um NFSv4 anzugeben.

      BEGIN
  DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name => 'FSS',
    file_system_location => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
    directory_name => 'FSS_DIR',
    description => 'Source FSS for sales data',

    **params => JSON_OBJECT('nfs_version' value 4)**
  );
END;
/

    In diesem Beispiel wird das im Parameter file_system_name angegebene Netzwerkdateisystem an die autonome KI-Datenbank angehängt.

    Der Parameter file_system_location gibt den Speicherort des Dateisystems an. Der Wert, den Sie mit file_system_location angeben, besteht aus einem vollqualifizierten Domainnamen (FQDN) und einem Dateipfad im Format: FQDN:file_path. Beispiel:

    • FQDN: myhost.sub000445.myvcn.oraclevcn.com

    • Dateipfad: /results

    Der Parameter directory_name gibt den Verzeichnisnamen in der autonomen KI-Datenbank an, an die Sie das Dateisystem anhängen möchten. Dies ist das Verzeichnis, das Sie in Schritt 1 erstellt haben, oder ein anderes Verzeichnis, das Sie zuvor erstellt haben.

    Der Parameter description gibt die Beschreibung für die Aufgabe an.

Hinweise zur Verwendung von DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM:

DBA_CLOUD_FILE_SYSTEMS abfragen

Nachdem Sie ein Dateisystem angehängt haben, können Sie die Ansicht DBA_CLOUD_FILE_SYSTEMS abfragen, um Informationen zum angehängten Dateisystem abzurufen.

Beispiel:

SELECT file_system_name, file_system_location, directory_path
  FROM dba_cloud_file_systems
  WHERE file_system_name = 'FSS';

Diese Abfrage gibt Details für den Dateisystemnamen FSS zurück. Weitere Informationen finden Sie in der Ansicht DBMS_CLOUD_FILE_SYSTEMS.

Mit einem angehängten Dateisystem können Sie mit jeder PL/SQL-API, die einen Verzeichnisnamen akzeptiert, in Dateien in einem angehängten Dateisystem lesen und schreiben. Beispiel: Sie können eine der folgenden Methoden verwenden, um mit einem angehängten FSS-Verzeichnis zu arbeiten:

Beispiel für das Schreiben einer Datei in ein angehängtes Dateisystem mit UTL_FILE:

DECLARE
  l_file         UTL_FILE.FILE_TYPE;
  l_location     VARCHAR2(100) := 'FSS_DIR';
  l_filename     VARCHAR2(100) := 'test.csv';
BEGIN
  -- Open the file.
  l_file := UTL_FILE.FOPEN(l_location, l_filename, 'w');

  UTL_FILE.PUT(l_file, 'Scott, male, 1000');

  -- Close the file.
  UTL_FILE.FCLOSE(l_file);
END;
/

Beispiel für das Lesen einer Datei in einem angehängten Dateisystem mit UTL_FILE:

DECLARE
  l_file         UTL_FILE.FILE_TYPE;
  l_location     VARCHAR2(100) := 'FSS_DIR';
  l_filename     VARCHAR2(100) := 'test.csv';
  l_text         VARCHAR2(32767);
BEGIN
  -- Open the file.
  l_file := UTL_FILE.FOPEN(l_location, l_filename, 'r');

  UTL_FILE.GET_LINE(l_file, l_text, 32767);

  -- Close the file.
  UTL_FILE.FCLOSE(l_file);
END;
/

Beispiel mit Listendateien in einem angehängten Dateisystem mit DBMS_CLOUD.LIST_FILES:

SELECT object_name FROM DBMS_CLOUD.LIST_FILES('FSS_DIR');

Ansicht - DBMS_CLOUD_FILE_SYSTEMS

In der Ansicht DBA_CLOUD_FILE_SYSTEMS werden die Informationen zum externen Dateisystem aufgeführt, das an ein Verzeichnis in der Datenbank angehängt ist.

Spalte Datentyp Beschreibung
FILE_SYSTEM_NAME VARCHAR2(128) Name des Dateisystems
FILE_SYSTEM_LOCATION VARCHAR2(4000) Dateisystemspeicherort
DIRECTORY_NAME VARCHAR2(128) Name des angehängten Verzeichnisses
DIRECTORY_PATH VARCHAR2(4000) Angehängter Verzeichnispfad
NFS_VERSION NUMBER Die NFS-Version
DESCRIPTION VARCHAR2(4000) Der angegebene Wert für den Beschreibungsparameter, wenn Sie DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM ausführen
CREATION_TIME TIMESTAMP(6) WITH TIME ZONE Erstellungszeitstempel
UPDATE_TIME TIMESTAMP(6) WITH TIME ZONE Zeitstempel aktualisieren

Externes Dateisystem trennen

Verwenden Sie die Prozedur DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM, um ein Dateisystem von einem Verzeichnis in Ihrer autonomen KI-Datenbank zu trennen.

Hinweis: Die Prozedur DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM kann einen privaten File Storage Service nur von den Datenbanken trennen, die sich auf privaten Endpunkten befinden.

Sie benötigen die Berechtigung WRITE für das Verzeichnisobjekt, um ein Dateisystem von einem Verzeichnis zu trennen.

Führen Sie die Prozedur DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM aus, um ein Dateisystem von einem Verzeichnis in der autonomen KI-Datenbank zu trennen. Um diese Prozedur ausführen zu können, müssen Sie als ADMIN-Benutzer angemeldet sein oder die Berechtigung EXECUTE für DBMS_CLOUD_ADMIN besitzen.

BEGIN
  DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM (
    file_system_name      => 'FSS'
);
END;
/

In diesem Beispiel wird das im Parameter file_system_name angegebene Netzwerkdateisystem von der autonomen KI-Datenbank getrennt. Sie müssen einen Wert für diesen Parameter angeben. Die Informationen zu diesem Dateisystem werden aus der Ansicht DBA_CLOUD_FILE_SYSTEMS entfernt.

Verwandte Inhalte

In den folgenden Themen finden Sie weitere Informationen: