# Realização de tarefas comuns diversas para instâncias de banco de dados Oracle Veja a seguir como executar diversas tarefas de DBA nas instâncias de banco de dados do Amazon RDS que executam o Oracle. Para oferecer uma experiência de serviço gerenciado, o Amazon RDS não fornece acesso ao shell para instâncias de bancos de dados e restringe o acesso a determinados procedimentos e tabelas do sistema que exigem privilégios avançados. **Topics** + [Criar e eliminar diretórios no espaço de armazenamento de dados principal](#Appendix.Oracle.CommonDBATasks.NewDirectories) + [Listagem de arquivos no diretório de uma instância de banco de dados](#Appendix.Oracle.CommonDBATasks.ListDirectories) + [Leitura de arquivos no diretório de uma instância de banco de dados](#Appendix.Oracle.CommonDBATasks.ReadingFiles) + [Acessar arquivos do Opatch](#Appendix.Oracle.CommonDBATasks.accessing-opatch-files) + [Gerenciando de tarefas do advisor](#Appendix.Oracle.CommonDBATasks.managing-advisor-tasks) + [Transportar espaços para tabela](rdsadmin_transport_util.md) ## Criar e eliminar diretórios no espaço de armazenamento de dados principal Para criar diretórios, use o procedimento do Amazon RDS `rdsadmin.rdsadmin_util.create_directory`. É possível criar até 10.000 diretórios, todas localizados no seu espaço de armazenamento físico de dados principal. Para criar diretórios, use o procedimento do Amazon RDS `rdsadmin.rdsadmin_util.drop_directory`. Os procedimentos `create_directory` e `drop_directory` têm o parâmetro necessário a seguir. **** | Nome do parâmetro | Tipo de dados | Padrão | Obrigatório | Descrição | | --- | --- | --- | --- | --- | | `p_directory_name` | VARCHAR2 | — | Sim | O nome do diretório. | O exemplo a seguir cria um novo diretório chamado `PRODUCT_DESCRIPTIONS`. ``` EXEC rdsadmin.rdsadmin_util.create_directory(p_directory_name => 'product_descriptions'); ``` O dicionário de dados armazena o nome do diretório em maiúsculas. Você pode listar os diretórios consultando `DBA_DIRECTORIES`. O sistema escolhe automaticamente o nome do caminho do host real. O exemplo a seguir obtém o caminho do diretório para o diretório chamado `PRODUCT_DESCRIPTIONS`: ``` SELECT DIRECTORY_PATH FROM DBA_DIRECTORIES WHERE DIRECTORY_NAME='PRODUCT_DESCRIPTIONS'; DIRECTORY_PATH ---------------------------------------- /rdsdbdata/userdirs/01 ``` O nome de usuário mestre para a instância de banco de dados tem privilégios de leitura e gravação no novo diretório e pode conceder acesso a outros usuários. Privilégios `EXECUTE` não estão disponíveis para diretórios em uma instância de banco de dados. Os diretórios são criados no seu espaço de armazenamento físico de dados principal e consumirão espaço e largura de banda de E/S. O exemplo a seguir elimina o diretório chamado `PRODUCT_DESCRIPTIONS`. ``` EXEC rdsadmin.rdsadmin_util.drop_directory(p_directory_name => 'product_descriptions'); ``` **nota** Também é possível descartar um diretório usando o comando do Oracle SQ `DROP DIRECTORY`. Descartar um diretório não remove seu conteúdo. Como o procedimento `rdsadmin.rdsadmin_util.create_directory` pode reutilizar nomes de caminhos, os arquivos em diretórios eliminados podem aparecer em um diretório recém-criado. Antes de eliminar um diretório, recomendamos que você use `UTL_FILE.FREMOVE` para remover arquivos do diretório. Para obter mais informações, consulte [Procedimento FREMOVE](https://docs.oracle.com/database/121/ARPLS/u_file.htm#ARPLS70924) na documentação da Oracle. ## Listagem de arquivos no diretório de uma instância de banco de dados Para listar os arquivos em um diretório, use o procedimento do Amazon RDS `rdsadmin.rds_file_util.listdir`. Esse procedimento não é compatível com uma réplica da Oracle. O procedimento `listdir` tem os seguintes parâmetros. **** | Nome do parâmetro | Tipo de dados | Padrão | Obrigatório | Descrição | | --- | --- | --- | --- | --- | | `p_directory` | varchar2 | — | Sim | O nome do diretório a ser listado. | O exemplo a seguir concede privilégios de leitura/gravação no diretório `PRODUCT_DESCRIPTIONS` para o usuário `rdsadmin` e, em seguida, lista os arquivos neste diretório. ``` GRANT READ,WRITE ON DIRECTORY PRODUCT_DESCRIPTIONS TO rdsadmin; SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'PRODUCT_DESCRIPTIONS')); ``` ## Leitura de arquivos no diretório de uma instância de banco de dados Para ler um arquivo de texto, use o procedimento do Amazon RDS `rdsadmin.rds_file_util.read_text_file`. O procedimento `read_text_file` tem os seguintes parâmetros. **** | Nome do parâmetro | Tipo de dados | Padrão | Obrigatório | Descrição | | --- | --- | --- | --- | --- | | `p_directory` | varchar2 | — | Sim | O nome do diretório que contém o arquivo. | | `p_filename` | varchar2 | — | Sim | O nome do arquivo a ser lido. | O exemplo a seguir cria o arquivo `rice.txt` no diretório `PRODUCT_DESCRIPTIONS`. ``` declare fh sys.utl_file.file_type; begin fh := utl_file.fopen(location=>'PRODUCT_DESCRIPTIONS', filename=>'rice.txt', open_mode=>'w'); utl_file.put(file=>fh, buffer=>'AnyCompany brown rice, 15 lbs'); utl_file.fclose(file=>fh); end; / ``` O exemplo a seguir lê o arquivo `rice.txt` do diretório `PRODUCT_DESCRIPTIONS`. ``` SELECT * FROM TABLE (rdsadmin.rds_file_util.read_text_file( p_directory => 'PRODUCT_DESCRIPTIONS', p_filename => 'rice.txt')); ``` ## Acessar arquivos do Opatch O Opatch é um utilitário do Oracle que permite a aplicação e a reversão de patches para o software do Oracle. O mecanismo do Oracle para determinar quais patches foram aplicados a um banco de dados é o comando `opatch lsinventory`. Para abrir solicitações de serviço para clientes de Traga sua própria licença (BYOL – Bring Your Own Licence), o suporte do Oracle solicita o arquivo `lsinventory` e, às vezes, o arquivo `lsinventory_detail` gerado pelo Opatch. Para oferecer uma experiência de serviço gerenciada, o Amazon RDS não fornece acesso ao shell para o Opatch. Em vez disso, o `lsinventory-dbv.txt` no diretório BDUMP contém as informações de patch relacionadas à versão atual do mecanismo. Quando você executa um upgrade principal ou secundário, o Amazon RDS atualiza `lsinventory-dbv.txt` em até uma hora após a aplicação do patch. Para verificar os patches aplicados, leia `lsinventory-dbv.txt`. Essa ação é semelhante a executar o comando `opatch lsinventory`. **nota** Os exemplos nesta seção pressupõem que o diretório BDUMP seja chamado `BDUMP`. Em uma réplica de leitura, o nome do diretório BDUMP é diferente. Para saber como obter o nome BDUMP consultando `V$DATABASE.DB_UNIQUE_NAME` em uma réplica de leitura, consulte [Listar arquivos](USER_LogAccess.Concepts.Oracle.md#USER_LogAccess.Concepts.Oracle.WorkingWithTracefiles.ViewingBackgroundDumpDest). Os arquivos de inventário usam a convenção de nomenclatura do Amazon RDS `lsinventory-dbv.txt` e `lsinventory_detail-dbv.txt`, onde *dbv* é o nome completo da versão do banco de dados. O arquivo `lsinventory-dbv.txt` está disponível em todas as versões do banco de dados. O `lsinventory_detail-dbv.txt` correspondente está disponível em 19.0.0.0, ru-2020-01.rur-2020-01.r1 ou posterior. Por exemplo, se a versão do seu banco de dados for 19.0.0.0.ru-2021-07.rur-2021-07.r1, os arquivos de inventário terão os nomes a seguir. ``` lsinventory-19.0.0.0.ru-2021-07.rur-2021-07.r1.txt lsinventory_detail-19.0.0.0.ru-2021-07.rur-2021-07.r1.txt ``` Baixe os arquivos que correspondem à versão atual do mecanismo de banco de dados. ### Console **Como baixar um arquivo de inventário usando o console** 1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. No painel de navegação, escolha **Databases (Bancos de dados)**. 1. Escolha o nome da instância de banco de dados que contém o arquivo de log que você deseja visualizar. 1. Escolha a guia **Logs & events (Logs e eventos)**. 1. Role para baixo até a seção **Logs**. 1. Na seção **Logs**, procure por `lsinventory`. 1. Escolha o arquivo que você deseja acessar e selecione **Download** (Baixar). ### SQL Para ler o `lsinventory-dbv.txt` em um cliente SQL, é possível usar uma instrução `SELECT`. Para esta técnica, use uma das seguintes funções `rdsadmin`: `rdsadmin.rds_file_util.read_text_file` ou `rdsadmin.tracefile_listing`. Na consulta de exemplo a seguir, substitua *dbv* pela versão do seu banco de dados Oracle. Por exemplo, a versão do seu banco de dados pode ser 19.0.0.0.ru-2020-04.rur-2020-04.r1. ``` SELECT text FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'lsinventory-dbv.txt')); ``` ### PL/SQL Para ler o `lsinventory-dbv.txt` em um cliente SQL, é possível escrever um programa PL/SQL. Esse programa usa `utl_file` para ler o arquivo e `dbms_output` para imprimi-lo. Esses são pacotes fornecidos pelo Oracle. No programa de exemplo a seguir, substitua *dbv* pela versão do seu banco de dados Oracle. Por exemplo, a versão do seu banco de dados pode ser 19.0.0.0.ru-2020-04.rur-2020-04.r1. ``` SET SERVEROUTPUT ON DECLARE v_file SYS.UTL_FILE.FILE_TYPE; v_line VARCHAR2(1000); v_oracle_home_type VARCHAR2(1000); c_directory VARCHAR2(30) := 'BDUMP'; c_output_file VARCHAR2(30) := 'lsinventory-dbv.txt'; BEGIN v_file := SYS.UTL_FILE.FOPEN(c_directory, c_output_file, 'r'); LOOP BEGIN SYS.UTL_FILE.GET_LINE(v_file, v_line,1000); DBMS_OUTPUT.PUT_LINE(v_line); EXCEPTION WHEN no_data_found THEN EXIT; END; END LOOP; END; / ``` Ou consulte `rdsadmin.tracefile_listing` e transfira a saída para um arquivo. O exemplo a seguir transfere a saída para `/tmp/tracefile.txt`. ``` SPOOL /tmp/tracefile.txt SELECT * FROM rdsadmin.tracefile_listing WHERE FILENAME LIKE 'lsinventory%'; SPOOL OFF; ``` ## Gerenciando de tarefas do advisor O banco de dados Oracle inclui vários advisors. Cada advisor suporta tarefas automatizadas e manuais. Você pode usar procedimentos no pacote `rdsadmin.rdsadmin_util` para gerenciar algumas tarefas do advisor. Os procedimentos de tarefas do advisor estão disponíveis nas seguintes versões do mecanismo: + Oracle Database 21c (21.0.0) + Versão 19.0.0.0.ru-2021-01.rur-2021-01.r1 e versões posteriores do Oracle Database 19c Para obter mais informações, consulte [Versão 19.0.0.0.ru-2021-01.rur-2021-01.r1](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/oracle-version-19-0.html#oracle-version-RU-RUR.19.0.0.0.ru-2021-01.rur-2021-01.r1) em *Notas de lançamento do Amazon RDS for Oracle*. **Topics** + [Definição de parâmetros para tarefas do advisor](#Appendix.Oracle.CommonDBATasks.setting-task-parameters) + [Desativação de AUTO\$1STATS\$1ADVISOR\$1TASK](#Appendix.Oracle.CommonDBATasks.dropping-advisor-task) + [Reativação de AUTO\$1STATS\$1ADVISOR\$1TASK](#Appendix.Oracle.CommonDBATasks.recreating-advisor-task) ### Definição de parâmetros para tarefas do advisor Para definir parâmetros para algumas tarefas do advisor, use o procedimento do Amazon RDS `rdsadmin.rdsadmin_util.advisor_task_set_parameter`. O procedimento `advisor_task_set_parameter` tem os seguintes parâmetros. **** | Nome do parâmetro | Tipo de dados | Padrão | Obrigatório | Descrição | | --- | --- | --- | --- | --- | | `p_task_name` | varchar2 | — | Sim | O nome da tarefa do advisor cujos parâmetros você deseja alterar. Os valores a seguir são válidos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/Appendix.Oracle.CommonDBATasks.Misc.html) | | `p_parameter` | varchar2 | — | Sim | O nome do parâmetro da tarefa. Para localizar parâmetros válidos para uma tarefa do advisor, execute a seguinte consulta. Substitua *p\$1task\$1name* com um valor válido para `p_task_name`: 
COL PARAMETER_NAME FORMAT a30
COL PARAMETER_VALUE FORMAT a30
SELECT PARAMETER_NAME, PARAMETER_VALUE
FROM DBA_ADVISOR_PARAMETERS
WHERE TASK_NAME='p_task_name'
AND PARAMETER_VALUE != 'UNUSED'
ORDER BY PARAMETER_NAME;
| | `p_value` | varchar2 | — | Sim | O valor de um parâmetro de tarefa. Para localizar valores válidos para parâmetros de tarefa, execute a seguinte consulta. Substitua *p\$1task\$1name* com um valor válido para `p_task_name`: 
COL PARAMETER_NAME FORMAT a30
COL PARAMETER_VALUE FORMAT a30
SELECT PARAMETER_NAME, PARAMETER_VALUE
FROM DBA_ADVISOR_PARAMETERS
WHERE TASK_NAME='p_task_name'
AND PARAMETER_VALUE != 'UNUSED'
ORDER BY PARAMETER_NAME;
| Os seguintes programas PL/SQL definem `ACCEPT_PLANS` como `FALSE` para `SYS_AUTO_SPM_EVOLVE_TASK`. A tarefa automatizada do Gerenciamento de Plano SQL verifica os planos e gera um relatório de suas descobertas, mas não evolui os planos automaticamente. Você pode usar um relatório para identificar novas listas de referência do plano SQL e aceitá-las manualmente. ``` BEGIN rdsadmin.rdsadmin_util.advisor_task_set_parameter( p_task_name => 'SYS_AUTO_SPM_EVOLVE_TASK', p_parameter => 'ACCEPT_PLANS', p_value => 'FALSE'); END; ``` Os seguintes programas PL/SQL definem `EXECUTION_DAYS_TO_EXPIRE` como `10` para `AUTO_STATS_ADVISOR_TASK`. A tarefa predefinida `AUTO_STATS_ADVISOR_TASK` é executada automaticamente na janela de manutenção uma vez por dia. O exemplo define o período de retenção para a execução da tarefa como 10 dias. ``` BEGIN rdsadmin.rdsadmin_util.advisor_task_set_parameter( p_task_name => 'AUTO_STATS_ADVISOR_TASK', p_parameter => 'EXECUTION_DAYS_TO_EXPIRE', p_value => '10'); END; ``` ### Desativação de AUTO\$1STATS\$1ADVISOR\$1TASK Para desativar `AUTO_STATS_ADVISOR_TASK`, use o procedimento do Amazon RDS `rdsadmin.rdsadmin_util.advisor_task_drop`. O procedimento `advisor_task_drop` aceita o parâmetro a seguir. **** | Nome do parâmetro | Tipo de dados | Padrão | Obrigatório | Descrição | | --- | --- | --- | --- | --- | | `p_task_name` | varchar2 | — | Sim | O nome da tarefa do advisor a ser desabilitada. O único valor válido é `AUTO_STATS_ADVISOR_TASK`. | Execute o seguinte comando: `AUTO_STATS_ADVISOR_TASK`. ``` EXEC rdsadmin.rdsadmin_util.advisor_task_drop('AUTO_STATS_ADVISOR_TASK') ``` Você pode reabilitar `AUTO_STATS_ADVISOR_TASK` usando `rdsadmin.rdsadmin_util.dbms_stats_init`. ### Reativação de AUTO\$1STATS\$1ADVISOR\$1TASK Para reativar `AUTO_STATS_ADVISOR_TASK`, use o procedimento do Amazon RDS `rdsadmin.rdsadmin_util.dbms_stats_init`. O procedimento `dbms_stats_init` não recebe parâmetros. O comando a seguir reativa `AUTO_STATS_ADVISOR_TASK`. ``` EXEC rdsadmin.rdsadmin_util.dbms_stats_init() ``` # Transportar espaços para tabela Use o pacote `rdsadmin.rdsadmin_transport_util` do Amazon RDS para copiar um conjunto de espaços para tabela de um banco de dados Oracle on-premises para uma instância de banco de dados do RDS para Oracle. No nível físico, o atributo de espaço para tabelas copia incrementalmente os arquivos de dados de origem e os arquivos de metadados para a instância de destino. Você pode transferir os arquivos usando o Amazon EFS ou o Amazon S3. Para ter mais informações, consulte [Migrar usando espaços de tabela transportáveis da Oracle](oracle-migrating-tts.md). **Topics** + [Importar espaços para tabela transportados para a instância de banco de dados](rdsadmin_transport_util_import_xtts_tablespaces.md) + [Importar metadados de espaços para tabela transportáveis para a instância de banco de dados](rdsadmin_transport_util_import_xtts_metadata.md) + [Listar arquivos órfãos após a importação de um espaço para tabela](rdsadmin_transport_util_list_xtts_orphan_files.md) + [Excluir arquivos de dados órfãos após a importação de espaços para tabela](rdsadmin_transport_util_cleanup_incomplete_xtts_import.md) # Importar espaços para tabela transportados para a instância de banco de dados Use o procedimento `rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces` para restaurar espaços para tabela que você exportou anteriormente de uma instância de banco de dados de origem. Na fase de transporte, você fará backup dos espaços para tabela somente leitura, exportará os metadados do Data Pump, transferirá esses arquivos para a instância de banco de dados de destino e, depois, importará os espaços para tabela. Para obter mais informações, consulte [Fase 4: Transportar os espaços de tabela](oracle-migrating-tts.md#oracle-migrating-tts.final-br-phase). ## Sintaxe ``` 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; ``` ## Parâmetros **** | Nome do parâmetro | Tipo de dados | Padrão | Obrigatório | Descrição | | --- | --- | --- | --- | --- | | `p_tablespace_list` | `CLOB` | — | Sim | A lista de espaços para tabela a serem importados. | | `p_directory_name` | `VARCHAR2` | — | Sim | O diretório que contém os backups de espaços para tabela. | | `p_platform_id` | `NUMBER` | `13` | Não | Forneça um ID de plataforma que corresponda ao especificado durante a fase de backup. Para encontrar uma lista de plataformas, consulte `V$TRANSPORTABLE_PLATFORM`. A plataforma padrão é Linux x86 de 64 bits, que é pouco comum. | | `p_parallel` | `INTEGER` | `0` | Não | O grau de paralelismo. Por padrão, o paralelismo está desabilitado. | ## Exemplos O exemplo a seguir importa os espaços de tabela *TBS1*, *TBS2* e *TBS3* do diretório *DATA\$1PUMP\$1DIR*. A plataforma de origem é de sistemas baseados em AIX (64 bits), que tem o ID da plataforma de `6`. É possível encontrar os IDs da plataforma consultando `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 ``` # Importar metadados de espaços para tabela transportáveis para a instância de banco de dados Use o procedimento `rdsadmin.rdsadmin_transport_util.import_xtts_metadata` para importar os metadados de espaços para tabela transportáveis para a instância de banco de dados do RDS para Oracle. Durante a operação, o status da importação de metadados é mostrado na tabela `rdsadmin.rds_xtts_operation_info`. Para obter mais informações, consulte [Etapa 5: Importar os metadados de espaços de tabela na instância de banco de dados de destino](oracle-migrating-tts.md#oracle-migrating-tts.transport.import-dmp). ## Sintaxe ``` 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); ``` ## Parâmetros **** | Nome do parâmetro | Tipo de dados | Padrão | Obrigatório | Descrição | | --- | --- | --- | --- | --- | | `p_datapump_metadata_file` | `SYS.DBA_DATA_FILES.FILE_NAME%TYPE` | — | Sim | O nome do arquivo Oracle Data Pump que contém os metadados de seus espaços para tabela transportáveis. | | `p_directory_name` | `VARCHAR2` | — | Sim | O diretório que contém o arquivo Data Pump. | | `p_exclude_stats` | `BOOLEAN` | `FALSE` | Não | Sinalizador que indica se as estatísticas devem ser excluídas. | | `p_remap_tablespace_list` | `CLOB` | NULL | Não | Uma lista de espaços para tabela a serem associados novamente durante a importação de metadados. Use o formato `from_tbs:to_tbs`. Por exemplo, especifique `users:user_data`. | | `p_remap_user_list` | `CLOB` | NULL | Não | Uma lista de esquemas de usuário a serem novamente associados durante a importação de metadados. Use o formato `from_schema_name:to_schema_name`. Por exemplo, especifique `hr:human_resources`. | ## Exemplos O exemplo importa os metadados de espaço para tabelas do arquivo *xttdump.dmp*, que está localizado no diretório *DATA\$1PUMP\$1DIR*. ``` BEGIN rdsadmin.rdsadmin_transport_util.import_xtts_metadata('xttdump.dmp','DATA_PUMP_DIR'); END; / ``` # Listar arquivos órfãos após a importação de um espaço para tabela Use o procedimento `rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files` para listar arquivos de dados que ficaram órfãos após a importação de espaços para tabela. Depois de identificar os arquivos de dados, você pode excluí-los chamando `rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import`. ## Sintaxe ``` FUNCTION list_xtts_orphan_files RETURN xtts_orphan_files_list_t PIPELINED; ``` ## Exemplos O exemplo a seguir executa o procedimento `rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files`. A saída mostra dois arquivos de dados que estão órfãos. ``` SQL> SELECT * FROM TABLE(rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files); FILENAME FILESIZE -------------- --------- datafile_7.dbf 104865792 datafile_8.dbf 104865792 ``` # Excluir arquivos de dados órfãos após a importação de espaços para tabela Use o procedimento `rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files` para excluir arquivos de dados que ficaram órfãos após a importação de espaços para tabela. A execução desse comando gera um arquivo de log que usa o formato do nome `rds-xtts-delete_xtts_orphaned_files-YYYY-MM-DD.HH24-MI-SS.FF.log` no diretório `BDUMP`. Use o procedimento `rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import` para encontrar os arquivos órfãos. Você pode ler o arquivo de log chamando o procedimento `rdsadmin.rds_file_util.read_text_file`. Para obter mais informações, consulte [Fase 6: Limpar os arquivos restantes](oracle-migrating-tts.md#oracle-migrating-tts.cleanup). ## Sintaxe ``` PROCEDURE cleanup_incomplete_xtts_import( p_directory_name IN VARCHAR2); ``` ## Parâmetros **** | Nome do parâmetro | Tipo de dados | Padrão | Obrigatório | Descrição | | --- | --- | --- | --- | --- | | `p_directory_name` | `VARCHAR2` | — | Sim | O diretório que contém os arquivos de dados órfãos. | ## Exemplos O exemplo a seguir exclui os arquivos de dados órfãos no *DATA\$1PUMP\$1DIR*. ``` BEGIN rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import('DATA_PUMP_DIR'); END; / ``` O exemplo a seguir lê o arquivo de log gerado pelo comando anterior. ``` 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. ```