# Atualização automática do arquivo de fuso horário do Oracle
Com a opção `TIMEZONE_FILE_AUTOUPGRADE`, é possível atualizar o arquivo de fuso horário atual para a versão mais recente na instância de banco de dados do RDS para Oracle.
**Topics**
+ [Visão geral dos arquivos de fuso horário da Oracle](Appendix.Oracle.Options.Timezone-file-autoupgrade.tz-overview.md)
+ [Estratégias para atualizar seu arquivo de fuso horário](Appendix.Oracle.Options.Timezone-file-autoupgrade.strategies.md)
+ [Tempo de inatividade durante a atualização do arquivo de fuso horário](Appendix.Oracle.Options.Timezone-file-autoupgrade.considerations.md)
+ [Preparação para atualizar o arquivo de fuso horário](Appendix.Oracle.Options.Timezone-file-autoupgrade.preparing.md)
+ [Adição da opção de atualização automática do arquivo de fuso horário](Appendix.Oracle.Options.Timezone-file-autoupgrade.adding.md)
+ [Verificação dos dados após a atualização do arquivo de fuso horário](Appendix.Oracle.Options.Timezone-file-autoupgrade.checking.md)
# Visão geral dos arquivos de fuso horário da Oracle
Um *arquivo de fuso horário* do Oracle Database armazena as seguintes informações:
+ Distância em relação ao Tempo Universal Coordenado (UTC)
+ Horários de transição para horário de verão (DST)
+ Abreviações para horário padrão e DST
O Oracle Database fornece várias versões de arquivos de fuso horário. Ao criar um banco de dados Oracle em um ambiente local, você escolhe a versão do arquivo de fuso horário. Para ter mais informações, consulte [Choosing a Time Zone File](https://docs.oracle.com/en/database/oracle/oracle-database/19/nlspg/datetime-data-types-and-time-zone-support.html#GUID-805AB986-DE12-4FEA-AF56-5AABCD2132DF) (Escolher um arquivo de fuso horário) no *Oracle Database Globalization Support Guide* (Guia de suporte à globalização de bancos de dados da Oracle).
Se as regras mudarem para DST, a Oracle publicará novos arquivos de fuso horário. A Oracle lança esses novos arquivos de fuso horário independentemente do cronograma de atualizações de versão (RUs) e revisões de atualização de versões (RURs) trimestrais. Os arquivos de fuso horário residem no host do banco de dados no diretório `$ORACLE_HOME/oracore/zoneinfo/`. Os nomes de arquivo de fuso horário usam o formato DStv*versão*, como em DSTv35.
## Como o arquivo de fuso horário afeta a transferência de dados
No Oracle Database, o tipo de dados `TIMESTAMP WITH TIME ZONE` armazena carimbo de data/hora e dados de fuso horário. Dados com o tipo de dados `TIMESTAMP WITH TIME ZONE` usam as regras na versão do arquivo de fuso horário associado. Assim, os dados `TIMESTAMP WITH TIME ZONE` existentes são afetados ao atualizar o arquivo de fuso horário.
Podem ocorrer problemas quando você transfere dados entre bancos de dados que usam versões diferentes do arquivo de fuso horário. Por exemplo, se você importar dados de um banco de dados de origem com uma versão de arquivo de fuso horário mais recente do que o do banco de dados de destino, o banco de dados emitirá o erro `ORA-39405`. Anteriormente, era necessário contornar esse erro usando uma das seguintes técnicas:
+ Crie uma instância de banco de dados do RDS para Oracle com o arquivo de fuso horário desejado, exporte dados do banco de dados de origem e importe-os para o novo banco de dados.
+ Use o AWS DMS ou replicação lógica para migrar seus dados.
## Atualizações automáticas usando a opção TIMEZONE\$1FILE\$1AUTOUPGRADE
Quando o grupo de opções anexado à instância de banco de dados do RDS para Oracle inclui a opção `TIMEZONE_FILE_AUTOUPGRADE`, o RDS atualiza os arquivos de fuso horário automaticamente. Ao garantir que os bancos de dados Oracle usem a mesma versão de arquivo de fuso horário, você evita técnicas manuais demoradas ao mover dados entre ambientes diferentes. A opção `TIMEZONE_FILE_AUTOUPGRADE` é compatível com bancos de dados de contêiner (CDBs) e não CDBs.
Ao adicionar a opção `TIMEZONE_FILE_AUTOUPGRADE` ao seu grupo de opções, você pode escolher se deseja adicionar a opção imediatamente ou durante a janela de manutenção. Depois que a instância de banco de dados usa a nova opção, o RDS confere se pode instalar um arquivo DSTv*version* mais recente. A *versão* de destino do DSTv depende do seguinte:
+ A versão de mecanismo secundária que sua instância de banco de dados está em execução atualmente
+ A versão secundária do mecanismo para a qual você deseja atualizar sua instância de banco de dados
Por exemplo, suponhamos que a versão atual do arquivo de fuso horário seja DSTv33. Ao aplicar a atualização ao grupo de opções, o RDS poderá determinar se DSTv34 está disponível atualmente no sistema de arquivos da instância de banco de dados. O RDS então atualizará o arquivo de fuso horário para DSTv34 automaticamente.
Para encontrar as versões de DST disponíveis nas atualizações da versão compatível do RDS, confira os patches em [Notas de versão do Amazon Relational Database Service (Amazon RDS) para Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/Welcome.html). Por exemplo, a [versão 19.0.0.0.ru-2022-10.rur-2022-10.r1](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/oracle-version-19-0.html#oracle-version-RU-RUR.19.0.0.0.ru-2022-10.rur-2022-10.r1) lista o patch 34533061: RDBMS – DSTV39 UPDATE – TZDATA2022C.
# Estratégias para atualizar seu arquivo de fuso horário
Atualizar o mecanismo de banco de dados e adicionar a opção `TIMEZONE_FILE_AUTOUPGRADE` a um grupo de opções são operações separadas. Adicionar a opção `TIMEZONE_FILE_AUTOUPGRADE` iniciará a atualização do arquivo de fuso horário se um mais recente estiver disponível. É necessário executar os seguintes comandos (somente as opções relevantes são mostradas) imediatamente ou na próxima janela de manutenção:
+ Atualize o mecanismo de banco de dados usando somente o seguinte comando da CLI do RDS:
```
modify-db-instance --engine-version name ...
```
+ Adicione a opção `TIMEZONE_FILE_AUTOUPGRADE` somente usando o seguinte comando da CLI:
```
add-option-to-option-group --option-group-name name --options OptionName=TIMEZONE_FILE_AUTOUPGRADE ...
```
+ Atualize o mecanismo de banco de dados e adicione um novo grupo de opções à instância usando o seguinte comando da CLI:
```
modify-db-instance --engine-version name --option-group-name name ...
```
A estratégia de atualização depende de atualizar o banco de dados e arquivo de fuso horário juntos ou realizar apenas uma dessas operações. Lembre-se de que, se você atualizar o grupo de opções e, depois, atualizar o mecanismo de banco de dados em operações de API separadas, é possível que uma atualização do arquivo de fuso horário esteja em andamento ao atualizar o mecanismo de banco de dados.
Para os exemplos nesta seção, suponha o seguinte:
+ Você ainda não adicionou `TIMEZONE_FILE_AUTOUPGRADE` ao grupo de opções atualmente associado à instância de banco de dados.
+ Sua instância de banco de dados usa a versão de banco de dados 19.0.0.0.ru-2019-07.rur-2019-07.r1 e o arquivo de fuso horário DSTv33.
+ O sistema de arquivos da sua instância de banco de dados inclui o arquivo DStv34.
+ A atualização de versão 19.0.0.0.ru-2022-10.rur-2022-10.r1 inclui DSTv35.
Para atualizar o arquivo de fuso horário, você pode usar as seguintes estratégias.
**Topics**
+ [Atualizar o arquivo de fuso horário sem atualizar o mecanismo](#Appendix.Oracle.Options.Timezone-file-autoupgrade.strategies.no-upgrade)
+ [Atualizar o arquivo de fuso horário e a versão do mecanismo de banco de dados](#Appendix.Oracle.Options.Timezone-file-autoupgrade.strategies.upgrade)
+ [Atualizar a versão do mecanismo de banco de dados sem atualizar o arquivo de fuso horário](#Appendix.Oracle.Options.Timezone-file-autoupgrade.strategies.upgrade-only)
## Atualizar o arquivo de fuso horário sem atualizar o mecanismo
Nesse cenário, seu banco de dados está usando o DSTv33, mas o DSTv34 está disponível no sistema de arquivos de sua instância de banco de dados. Você deseja atualizar o arquivo de fuso horário usado por sua instância de banco de dados de DSTv33 para DSTv34, mas não deseja atualizar seu mecanismo para uma nova versão secundária, que inclua DSTv35.
Em um comando `add-option-to-option-group`, adicione `TIMEZONE_FILE_AUTOUPGRADE` ao grupo de opções usado pela instância de banco de dados. Especifique se deseja adicionar a opção imediatamente ou adiá-la para a janela de manutenção. Depois de aplicar a opção `TIMEZONE_FILE_AUTOUPGRADE`, o RDS faz o seguinte:
1. Confere se há uma nova versão do DST.
1. Determina se o DSTv34 está disponível no sistema de arquivos.
1. Atualiza o arquivo de fuso horário imediatamente.
## Atualizar o arquivo de fuso horário e a versão do mecanismo de banco de dados
Nesse cenário, seu banco de dados está usando o DSTv33, mas o DSTv34 está disponível no sistema de arquivos de sua instância de banco de dados. Você deseja atualizar seu mecanismo de banco de dados para a versão secundária 19.0.0.0.ru-2022-10.rur-2022-10.r1, que inclui DSTv35 e atualizar o arquivo de fuso horário para DSTv35 durante a atualização do mecanismo. Portanto, seu objetivo é ignorar o DSTv34 e atualizar os arquivos de fuso horário diretamente para DSTv35.
Para atualizar o mecanismo e o arquivo de fuso horário juntos, execute `modify-db-instance` com as opções `--option-group-name` e `--engine-version`. É possível executar o comando imediatamente ou adiá-lo para a janela de manutenção. `In --option-group-name`, especifique um grupo de opções que inclua a opção `TIMEZONE_FILE_AUTOUPGRADE`. Por exemplo:
```
aws rds modify-db-instance
--db-instance-identifier my-instance \
--engine-version new-version \
----option-group-name og-with-timezone-file-autoupgrade \
--apply-immediately
```
O RDS começa a atualizar o mecanismo para 19.0.0.0.ru-2022-10.rur-2022-10.r1. Depois que a opção `TIMEZONE_FILE_AUTOUPGRADE` é aplicada, o RDS confere se há uma nova versão do DST, percebe que o DSTv35 está disponível em 19.0.0.0.ru-2022-10.rur-2022-10.r1 e inicia imediatamente a atualização para DSTv35.
Para atualizar o mecanismo imediatamente e, depois, atualizar o arquivo de fuso horário, execute as operações na sequência:
1. Atualize o mecanismo de banco de dados usando o seguinte comando da CLI:
```
aws rds modify-db-instance \
--db-instance-identifier my-instance \
--engine-version new-version \
--apply-immediately
```
1. Adicione a opção `TIMEZONE_FILE_AUTOUPGRADE` ao grupo de opções anexado à instância usando o seguinte comando da CLI:
```
aws rds add-option-to-option-group \
--option-group-name og-in-use-by-your-instance \
--options OptionName=TIMEZONE_FILE_AUTOUPGRADE \
--apply-immediately
```
## Atualizar a versão do mecanismo de banco de dados sem atualizar o arquivo de fuso horário
Nesse cenário, seu banco de dados está usando o DSTv33, mas o DSTv34 está disponível no sistema de arquivos de sua instância de banco de dados. Você deseja atualizar seu mecanismo de banco de dados para a versão 19.0.0.0.ru-2022-10.rur-2022-10.r1, que inclui o DSTv35, mas reter o arquivo de fuso horário DSTv33. Você pode fazer isso pelas seguintes razões:
+ Seus dados não usam o tipo de dados `TIMESTAMP WITH TIME ZONE`.
+ Seus dados usam o tipo de dados `TIMESTAMP WITH TIME ZONE`, mas eles não são afetados pelas alterações de fuso horário.
+ Você deseja adiar a atualização do arquivo de fuso horário porque não pode tolerar o tempo de inatividade extra.
Sua estratégia depende de qual das seguintes possibilidades é verdadeira:
+ Sua instância de banco de dados não está associada a um grupo de opções que inclui `TIMEZONE_FILE_AUTOUPGRADE`. No comando `modify-db-instance`, não especifique um novo grupo de opções para que o RDS não atualize o arquivo de fuso horário.
+ A instância de banco de dados está atualmente associada a um grupo de opções que inclui `TIMEZONE_FILE_AUTOUPGRADE`. Em m um único comando `modify-db-instance`, associe a instância de banco de dados a um grupo de opções que não inclua `TIMEZONE_FILE_AUTOUPGRADE` e, depois, atualize o mecanismo de banco de dados para 19.0.0.0.ru-2022-10.rur-2022-10.r1.
# Tempo de inatividade durante a atualização do arquivo de fuso horário
Quando o RDS atualiza o arquivo de fuso horário, os dados existentes que utilizam `TIMESTAMP WITH TIME ZONE` podem mudar. Nesse caso, sua consideração principal é o tempo de inatividade.
**Atenção**
Se você adicionar a opção `TIMEZONE_FILE_AUTOUPGRADE`, a atualização do mecanismo poderá exigir um tempo de inatividade prolongado. A atualização de dados de fuso horário para um banco de dados grande pode levar horas ou até dias.
A duração da atualização do arquivo de fuso horário depende de fatores como os seguintes:
+ A quantidade de dados `TIMESTAMP WITH TIME ZONE` em seu banco de dados
+ A configuração da instância de banco de dados
+ Classe da instância de banco de dados
+ A configuração do armazenamento
+ A configuração do banco de dados:
+ As configurações de parâmetros do banco de dados
Um período de inatividade adicional pode ocorrer quando você:
+ Adiciona a opção ao grupo de opções quando a instância de banco de dados usa um arquivo de fuso horário desatualizado
+ Atualiza o mecanismo de banco de dados Oracle quando a nova versão do mecanismo contém uma nova versão do arquivo de fuso horário
**nota**
Durante a atualização do arquivo de fuso horário, o RDS for Oracle chama `PURGE DBA_RECYCLEBIN`.
# Preparação para atualizar o arquivo de fuso horário
Uma atualização de arquivo de fuso horário tem duas fases separadas: preparar e atualizar. Embora não seja necessário, recomendamos enfaticamente que você execute a etapa de preparação. Nessa etapa, você descobre quais dados serão afetados pela execução do procedimento de PL/SQL `DBMS_DST.FIND_AFFECTED_TABLES`. Para ter mais informações sobre a janela de preparação, consulte [Upgrading the Time Zone File and Timestamp with Time Zone Data](https://docs.oracle.com/en/database/oracle/oracle-database/19/nlspg/datetime-data-types-and-time-zone-support.html#GUID-B0ACDB2E-4B49-4EB4-B4CC-9260DAE1567A) (Atualização do arquivo de fuso horário e o carimbo de data/hora com os dados de fuso horário) na documentação do Oracle Database.
**Para preparar a atualização do arquivo de fuso horário**
1. Conecte ao banco de dados Oracle usando um cliente SQL.
1. Determine a versão atual do arquivo de fuso horário usada.
```
SELECT * FROM V$TIMEZONE_FILE;
```
1. Determine a versão mais recente do arquivo de fuso horário disponível na instância de banco de dados
```
SELECT DBMS_DST.GET_LATEST_TIMEZONE_VERSION FROM DUAL;
```
1. Determine o tamanho total das tabelas que têm colunas do tipo `TIMESTAMP WITH LOCAL TIME ZONE` ou `TIMESTAMP WITH TIME ZONE`.
```
SELECT SUM(BYTES)/1024/1024/1024 "Total_size_w_TSTZ_columns_GB"
FROM DBA_SEGMENTS
WHERE SEGMENT_TYPE LIKE 'TABLE%'
AND (OWNER, SEGMENT_NAME) IN
(SELECT OWNER, TABLE_NAME
FROM DBA_TAB_COLUMNS
WHERE DATA_TYPE LIKE 'TIMESTAMP%TIME ZONE');
```
1. Determine os nomes e tamanhos dos segmentos que têm colunas do tipo `TIMESTAMP WITH LOCAL TIME ZONE` ou `TIMESTAMP WITH TIME ZONE`.
```
SELECT OWNER, SEGMENT_NAME, SUM(BYTES)/1024/1024/1024 "SEGMENT_SIZE_W_TSTZ_COLUMNS_GB"
FROM DBA_SEGMENTS
WHERE SEGMENT_TYPE LIKE 'TABLE%'
AND (OWNER, SEGMENT_NAME) IN
(SELECT OWNER, TABLE_NAME
FROM DBA_TAB_COLUMNS
WHERE DATA_TYPE LIKE 'TIMESTAMP%TIME ZONE')
GROUP BY OWNER, SEGMENT_NAME;
```
1. Execute a etapa de preparação.
+ O procedimento `DBMS_DST.CREATE_AFFECTED_TABLE` cria uma tabela para armazenar quaisquer dados afetados. Passe o nome desta tabela ao procedimento `DBMS_DST.FIND_AFFECTED_TABLES`. Para ter mais informações, consulte [CREATE\$1AFFECTED\$1TABLE Procedure](https://docs.oracle.com/en/database/oracle/oracle-database/19/arpls/DBMS_DST.html#GUID-C53BAABA-914A-404C-9CD5-823257BE0B00) (Procedimento CREATE\$1AFECTED\$1TABLE) na documentação do Oracle Database.
+ O procedimento `CREATE_ERROR_TABLE` cria uma tabela para registrar erros. Para ter mais informações, consulte [CREATE\$1ERROR\$1TABLE Procedure](https://docs.oracle.com/en/database/oracle/oracle-database/19/arpls/DBMS_DST.html#GUID-6A7EA024-B02D-4486-B1D6-EF6ABF5DE507) (Procedimento ERROR\$1TABLE) na documentação do Oracle Database.
O exemplo a seguir cria os dados afetados e as tabelas de erro e localiza todas as tabelas de afetados.
```
EXEC DBMS_DST.CREATE_ERROR_TABLE('my_error_table')
EXEC DBMS_DST.CREATE_AFFECTED_TABLE('my_affected_table')
EXEC DBMS_DST.BEGIN_PREPARE(new_version);
EXEC DBMS_DST.FIND_AFFECTED_TABLES('my_affected_table', TRUE, 'my_error_table');
EXEC DBMS_DST.END_PREPARE;
SELECT * FROM my_affected_table;
SELECT * FROM my_error_table;
```
1. Consulte as tabelas de afetados e de erro.
```
SELECT * FROM my_affected_table;
SELECT * FROM my_error_table;
```
# Adição da opção de atualização automática do arquivo de fuso horário
Quando você adiciona a opção a um grupo de opções, o grupo de opções está em um dos seguintes estados:
+ Um grupo de opções existente está atualmente anexado a pelo menos uma instância de banco de dados. Quando você adiciona a opção, todas as instâncias de banco de dados que usam esse grupo de opções são reiniciadas automaticamente. Isso causa uma breve interrupção.
+ Um grupo de opções existente não está anexado a nenhuma instância de banco de dados. Você planeja adicionar a opção, depois associar o grupo de opções existente às instâncias de banco de dados existentes ou a uma nova instância de banco de dados.
+ Você cria um grupo de opções e adiciona a opção. Você planeja adicionar o novo grupo de opções às instâncias de banco de dados existentes ou a uma nova instância de banco de dados.
## Console
**Para adicionar a opção de atualização automática do arquivo de fuso horário a uma instância de banco de dados**
1. Faça login no Console de gerenciamento da AWS e 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 **Option groups (Grupos de opções)**.
1. Determine o grupo de opções que você deseja usar. Você pode criar um novo grupo de opções ou usar um existente. Se você quiser usar um grupo de opções existente, vá para a próxima etapa. Caso contrário, crie um grupo de opções de banco de dados personalizado com as seguintes configurações:
1. Em **Engine** (Mecanismo), escolha a edição do Oracle Database para sua instância de banco de dados.
1. Para **Major engine version (Versão do mecanismo principal)**, escolha a versão da sua instância de banco de dados.
Para ter mais informações, consulte [Criar um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create).
1. Selecione o grupo de opções que você deseja modificar e escolha **Add Option (Adicionar opção)**.
1. Na janela **Add option (Adicionar opção)**, faça o seguinte:
1. Escolha **TIMEZONE\$1FILE\$1AUTOUPGRADE**.
1. Para habilitar a opção em todas as instâncias de banco de dados associadas assim que você a adicionar, em **Apply Immediately (Aplicar imediatamente)**, escolha **Yes (Sim)**. Se você escolher **No (Não)** (o padrão), a opção será habilitada para cada instância de banco de dados associada durante sua próxima janela de manutenção.
1. Quando estiver satisfeito com as configurações, escolha **Add Option (Adicionar opção)**.
## AWS CLI
O exemplo a seguir usa o comando da AWS CLI [add-option-to-option-group](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) para adicionar a opção `TIMEZONE_FILE_AUTOUPGRADE` a um grupo de opções chamado `myoptiongroup`.
Para Linux, macOS ou Unix:
```
aws rds add-option-to-option-group \
--option-group-name "myoptiongroup" \
--options "OptionName=TIMEZONE_FILE_AUTOUPGRADE" \
--apply-immediately
```
Para Windows:
```
aws rds add-option-to-option-group ^
--option-group-name "myoptiongroup" ^
--options "OptionName=TIMEZONE_FILE_AUTOUPGRADE" ^
--apply-immediately
```
# Verificação dos dados após a atualização do arquivo de fuso horário
Recomendamos verificar seus dados após atualizar o arquivo de fuso horário. Durante a etapa de preparação, o RDS for Oracle cria automaticamente as seguintes tabelas:
+ `rdsadmin.rds_dst_affected_tables`: lista as tabelas que contêm dados afetados pela atualização
+ `rdsadmin.rds_dst_error_table`: lista os erros gerados durante a atualização
Essas tabelas são independentes de todas as tabelas criadas na janela de preparação. Para ver os resultados da atualização, consulte as tabelas conforme mostrado a seguir.
```
SELECT * FROM rdsadmin.rds_dst_affected_tables;
SELECT * FROM rdsadmin.rds_dst_error_table;
```
Para ter mais informações sobre o esquema das tabelas de dados afetados e de erros, consulte [FIND\$1AFFECTED\$1TABLES Procedure](https://docs.oracle.com/en/database/oracle/oracle-database/19/arpls/DBMS_DST.html#GUID-1F977505-671C-4D5B-8570-86956F136199) (Processo FIND\$1AFECTED\$1TABLES) na documentação do Oracle.