Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Transport von Tabellenbereichen
<a name="rdsadmin_transport_util"></a>

Verwenden Sie das Amazon-RDS-Paket `rdsadmin.rdsadmin_transport_util`, um eine Reihe von Tabellenbereichen aus einer On-Premises-Oracle-Datenbank auf eine DB-Instance von RDS für Oracle zu kopieren. Auf physischer Ebene kopiert die Funktion für transportable Tabellenbereiche inkrementell Quelldatendateien und Metadatendateien auf Ihre Ziel-Instance. Sie können die Dateien entweder mit Amazon EFS oder mit Amazon S3 übertragen. Weitere Informationen finden Sie unter [Migrieren mithilfe von Oracle Transportable Tablespaces](oracle-migrating-tts.md).

**Topics**
+ [Importieren transportabler Tabellenbereiche in Ihre DB-Instance](rdsadmin_transport_util_import_xtts_tablespaces.md)
+ [Importieren von Metadaten transportabler Tabellenbereiche in Ihre DB-Instance](rdsadmin_transport_util_import_xtts_metadata.md)
+ [Auflisten verwaister Dateien nach einem Tabellenbereichimport](rdsadmin_transport_util_list_xtts_orphan_files.md)
+ [Löschen verwaister Dateien nach einem Tabellenbereichimport](rdsadmin_transport_util_cleanup_incomplete_xtts_import.md)

# Importieren transportabler Tabellenbereiche in Ihre DB-Instance
<a name="rdsadmin_transport_util_import_xtts_tablespaces"></a>

Verwenden Sie das Verfahren `rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces`, um Tabellenbereiche wiederherzustellen, die Sie zuvor aus einer Quell-DB-Instance exportiert haben. In der Transportphase sichern Sie Ihre schreibgeschützten Tabellenbereiche und exportieren Data-Pump-Metadaten, übertragen diese Dateien auf Ihre Ziel-DB-Instance und importieren dann die Tabellenbereiche. Weitere Informationen finden Sie unter [Phase 4: Transportieren der Tabellenbereiche](oracle-migrating-tts.md#oracle-migrating-tts.final-br-phase). 

## Syntax
<a name="rdsadmin_transport_util_import_xtts_tablespaces-syntax"></a>

```
FUNCTION import_xtts_tablespaces(
    p_tablespace_list IN CLOB,
    p_directory_name  IN VARCHAR2,
    p_platform_id     IN NUMBER DEFAULT 13,
    p_parallel        IN INTEGER DEFAULT 0) RETURN VARCHAR2;
```

## Parameters
<a name="rdsadmin_transport_util_import_xtts_tablespaces-parameters"></a>


****  

| Parametername | Datentyp | Standard | Erforderlich | Beschreibung | 
| --- | --- | --- | --- | --- | 
|  `p_tablespace_list`  |  `CLOB`  |  —  |  Ja  |  Die Liste der zu importierenden Tabellenbereiche.  | 
|  `p_directory_name`  |  `VARCHAR2`  |  —  |  Ja  | Das Verzeichnis, das die Backups der Tabellenbereiche enthält. | 
|  `p_platform_id`  |  `NUMBER`  |  `13`  |  Nein  |  Geben Sie eine Plattform-ID an, die mit der in der Backup-Phase angegebenen ID übereinstimmt. Fragen Sie `V$TRANSPORTABLE_PLATFORM` ab, um eine Liste der Plattformen zu finden. Die Standardplattform ist Linux x86 64-Bit, was das Little-Endian-Format ist.  | 
|  `p_parallel`  |  `INTEGER`  |  `0`  |  Nein  |  Der Grad der Parallelität. In der Standardeinstellung ist Parallelität deaktiviert.  | 

## Beispiele
<a name="rdsadmin_transport_util_import_xtts_tablespaces-examples"></a>

Im folgenden Beispiel werden die Tablespaces *TBS1**TBS2*, und *TBS3* aus dem Verzeichnis importiert. *DATA\$1PUMP\$1DIR* Die Quellplattform ist ein AIX-basiertes System (64-Bit) mit der Plattform-ID `6`. Sie können die Plattform finden, IDs indem Sie sie abfragen. `V$TRANSPORTABLE_PLATFORM`

```
VAR task_id CLOB

BEGIN
  :task_id:=rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces(
        'TBS1,TBS2,TBS3',
        'DATA_PUMP_DIR',
        p_platform_id => 6);
END;
/

PRINT task_id
```

# Importieren von Metadaten transportabler Tabellenbereiche in Ihre DB-Instance
<a name="rdsadmin_transport_util_import_xtts_metadata"></a>

Verwenden Sie das Verfahren `rdsadmin.rdsadmin_transport_util.import_xtts_metadata`, um Metadaten transportabler Tabellenbereiche in Ihre DB-Instance von RDS für Oracle zu importieren. Während des Vorgangs wird der Status des Metadatenimports in der Tabelle `rdsadmin.rds_xtts_operation_info` angezeigt. Weitere Informationen finden Sie unter [Schritt 5: Importieren der Tabellenbereich-Metadaten in Ihre Ziel-DB-Instance](oracle-migrating-tts.md#oracle-migrating-tts.transport.import-dmp).

## Syntax
<a name="rdsadmin_transport_util_import_xtts_metadata-syntax"></a>

```
PROCEDURE import_xtts_metadata(
    p_datapump_metadata_file IN SYS.DBA_DATA_FILES.FILE_NAME%TYPE,
    p_directory_name         IN VARCHAR2,
    p_exclude_stats          IN BOOLEAN DEFAULT FALSE,
    p_remap_tablespace_list  IN CLOB DEFAULT NULL,
    p_remap_user_list        IN CLOB DEFAULT NULL);
```

## Parameters
<a name="rdsadmin_transport_util_import_xtts_metadata-parameters"></a>


****  

| Parametername | Datentyp | Standard | Erforderlich | Beschreibung | 
| --- | --- | --- | --- | --- | 
|  `p_datapump_metadata_file`  |  `SYS.DBA_DATA_FILES.FILE_NAME%TYPE`  |  —  |  Ja  |  Der Name der Oracle-Data-Pump-Datei, die die Metadaten für Ihre transportablen Tabellenbereiche enthält.  | 
|  `p_directory_name`  |  `VARCHAR2`  |  —  |  Ja  |  Das Verzeichnis, das die Data-Pump-Datei enthält.  | 
|  `p_exclude_stats`  |  `BOOLEAN`  |  `FALSE`  |  Nein  |  Flag, das angibt, ob Statistiken ausgeschlossen werden sollen.  | 
|  `p_remap_tablespace_list`  |  `CLOB`  |  NULL  |  Nein  |  Eine Liste von Tabellenbereichen, die beim Metadatenimport neu zugeordnet werden sollen. Verwenden Sie dabei das Format `from_tbs:to_tbs`. Geben Sie beispielsweise `users:user_data` an.   | 
|  `p_remap_user_list`  |  `CLOB`  |  NULL  |  Nein  |  Eine Liste von Benutzerschemata, die beim Metadatenimport neu zugeordnet werden sollen. Verwenden Sie dabei das Format `from_schema_name:to_schema_name`. Geben Sie beispielsweise `hr:human_resources` an.   | 

## Beispiele
<a name="rdsadmin_transport_util_import_xtts_metadata-examples"></a>

Das Beispiel importiert die Tablespace-Metadaten aus der Datei*xttdump.dmp*, die sich im Verzeichnis *DATA\$1PUMP\$1DIR* befindet.

```
BEGIN
  rdsadmin.rdsadmin_transport_util.import_xtts_metadata('xttdump.dmp','DATA_PUMP_DIR');
END;
/
```

# Auflisten verwaister Dateien nach einem Tabellenbereichimport
<a name="rdsadmin_transport_util_list_xtts_orphan_files"></a>

Verwenden Sie das Verfahren `rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files`, um Datendateien aufzulisten, die nach einem Tabellenbereichimport verwaist waren. Nachdem Sie die Datendateien identifiziert haben, können Sie sie löschen, indem Sie `rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import` aufrufen.

## Syntax
<a name="rdsadmin_transport_util_list_xtts_orphan_files-syntax"></a>

```
FUNCTION list_xtts_orphan_files RETURN xtts_orphan_files_list_t PIPELINED;
```

## Beispiele
<a name="rdsadmin_transport_util_list_xtts_orphan_files-examples"></a>

Das folgende Beispiel führt die Prozedur `rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files` aus. Die Ausgabe zeigt zwei verwaiste Datendateien.

```
SQL> SELECT * FROM TABLE(rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files);

FILENAME       FILESIZE
-------------- ---------
datafile_7.dbf 104865792
datafile_8.dbf 104865792
```

# Löschen verwaister Dateien nach einem Tabellenbereichimport
<a name="rdsadmin_transport_util_cleanup_incomplete_xtts_import"></a>

Verwenden Sie das Verfahren `rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files`, um Datendateien zu löschen, die nach einem Tabellenbereichimport verwaist waren. Wenn Sie diesen Befehl ausführen, wird eine Protokolldatei generiert, die das Namensformat `rds-xtts-delete_xtts_orphaned_files-YYYY-MM-DD.HH24-MI-SS.FF.log` im Verzeichnis `BDUMP` verwendet. Verwenden Sie das Verfahren `rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import`, um die verwaisten Dateien zu finden. Sie können die Protokolldatei lesen, indem Sie das Verfahren `rdsadmin.rds_file_util.read_text_file` aufrufen. Weitere Informationen finden Sie unter [Phase 6: Bereinigen übrig gebliebener Dateien](oracle-migrating-tts.md#oracle-migrating-tts.cleanup).

## Syntax
<a name="rdsadmin_transport_util_cleanup_incomplete_xtts_import-syntax"></a>

```
PROCEDURE cleanup_incomplete_xtts_import(
    p_directory_name IN VARCHAR2);
```

## Parameters
<a name="rdsadmin_transport_util_cleanup_incomplete_xtts_import-parameters"></a>


****  

| Parametername | Datentyp | Standard | Erforderlich | Beschreibung | 
| --- | --- | --- | --- | --- | 
|  `p_directory_name`  |  `VARCHAR2`  |  —  |  Ja  |  Das Verzeichnis, das die verwaisten Datendateien enthält.  | 

## Beispiele
<a name="rdsadmin_transport_util_cleanup_incomplete_xtts_import-examples"></a>

Im folgenden Beispiel werden die verwaisten Datendateien in gelöscht. *DATA\$1PUMP\$1DIR*

```
BEGIN
  rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import('DATA_PUMP_DIR');
END;
/
```

Das folgende Beispiel liest die durch den vorherigen Befehl generierte Protokolldatei. 

```
SELECT * 
FROM TABLE(rdsadmin.rds_file_util.read_text_file(
       p_directory => 'BDUMP',
       p_filename  => 'rds-xtts-delete_xtts_orphaned_files-2023-06-01.09-33-11.868894000.log'));

TEXT
--------------------------------------------------------------------------------
orphan transported datafile datafile_7.dbf deleted.
orphan transported datafile datafile_8.dbf deleted.
```