

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Persiapan untuk memperbarui file zona waktu
<a name="Appendix.Oracle.Options.Timezone-file-autoupgrade.preparing"></a>

Pemutakhiran file zona waktu memiliki dua fase terpisah: siapkan dan mutakhirkan. Meskipun tidak diperlukan, sebaiknya lakukan langkah persiapan. Pada langkah ini, Anda mengetahui data mana yang akan terpengaruh dengan menjalankan PL/SQL prosedur`DBMS_DST.FIND_AFFECTED_TABLES`. Untuk informasi selengkapnya tentang periode persiapan, lihat [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) di dokumentasi Oracle Database.

**Sebagai persiapan untuk memperbarui file zona waktu**

1. Terhubung ke basis data Oracle Anda menggunakan klien SQL.

1. Tentukan versi file zona waktu saat ini yang digunakan.

   ```
   SELECT * FROM V$TIMEZONE_FILE;
   ```

1. Tentukan versi file zona waktu terbaru yang tersedia di instans DB Anda.

   ```
   SELECT DBMS_DST.GET_LATEST_TIMEZONE_VERSION FROM DUAL;
   ```

1. Tentukan ukuran total tabel yang memiliki kolom tipe `TIMESTAMP WITH LOCAL TIME ZONE` atau `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. Tentukan nama dan ukuran segmen yang memiliki kolom tipe `TIMESTAMP WITH LOCAL TIME ZONE` atau `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. Jalankan langkah persiapan. 
   + Prosedur `DBMS_DST.CREATE_AFFECTED_TABLE` membuat tabel untuk menyimpan data yang terpengaruh. Anda meneruskan nama tabel ini ke prosedur `DBMS_DST.FIND_AFFECTED_TABLES`. Untuk informasi selengkapnya, lihat [CREATE\$1AFFECTED\$1TABLE Procedure](https://docs.oracle.com/en/database/oracle/oracle-database/19/arpls/DBMS_DST.html#GUID-C53BAABA-914A-404C-9CD5-823257BE0B00) di dokumentasi Oracle Database.
   + Prosedur `CREATE_ERROR_TABLE` membuat tabel untuk mencatat kesalahan. Untuk informasi selengkapnya, lihat [CREATE\$1ERROR\$1TABLE Procedure](https://docs.oracle.com/en/database/oracle/oracle-database/19/arpls/DBMS_DST.html#GUID-6A7EA024-B02D-4486-B1D6-EF6ABF5DE507) di dokumentasi Oracle Database.

   Contoh berikut membuat data dan tabel kesalahan yang terpengaruh, dan menemukan semua tabel yang terpengaruh.

   ```
   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. Kueri tabel yang terpengaruh dan memiliki kesalahan.

   ```
   SELECT * FROM my_affected_table;
   SELECT * FROM my_error_table;
   ```