Ekstensi Penilaian Migrasi Database untuk Oracle

Ekstensi Penilaian Migrasi Database untuk Oracle di Azure Data Studio membantu Anda menilai beban kerja Oracle untuk bermigrasi ke Azure SQL dan Azure Database for PostgreSQL. Ekstensi mengidentifikasi target Azure SQL atau PostgreSQL yang sesuai dengan rekomendasi ukuran yang tepat, dan seberapa kompleks migrasinya.

Prasyarat

Menginstal ekstensi Azure Data Studio

Ikuti langkah-langkah ini untuk menginstal penilaian migrasi database untuk ekstensi Oracle di Azure Data Studio.

  1. Buka manajer ekstensi di Azure Data Studio. Anda dapat memilih ikon ekstensi atau memilih Ekstensi di menu Tampilan.

  2. Ketik Oracle di bilah pencarian.

  3. Pilih ekstensi Penilaian Migrasi Database untuk Oracle dan lihat detailnya.

  4. Pilih Instal.

    Screenshot of installing the extension.

Mengonfigurasi pengaturan ekstensi

Anda dapat mengonfigurasi beberapa pengaturan ekstensi setelah menginstal ekstensi.

  1. Buka ekstensi dan pilih Penilaian Migrasi Database untuk Oracle, pilih ikon kelola pengaturan, lalu pilih pengaturan ekstensi.

    Screenshot of extension.

  2. Di bawah pengaturan ekstensi, edit pengaturan ekstensi apa pun untuk memenuhi persyaratan lingkungan.

    Screenshot of extension properties settings.

    Catatan

    Untuk melakukan penilaian kode Oracle ke PostgreSQL, jalur beranda klien Oracle dan jalur penginstalan Ora2Pg adalah parameter wajib.

Jalankan penilaian

Setelah ekstensi penilaian diinstal, langkah selanjutnya adalah menyambungkan ke Oracle database Anda, mengumpulkan informasi metadata dari instans Oracle Anda dan membuat laporan penilaian.

  1. Buka ikon koneksi di bilah menu.

    Screenshot of connections menu bar.

  2. Di Detail Koneksi ion, isi bidang.

    1. Di bidang jenis Koneksi ion, pilih Oracle.
    2. Di bidang Sumber Data, ketik nama server dan instans Oracle Anda.
      1. Anda juga dapat memberikan nama TNS. (Pastikan variabel ORACLE_HOME lingkungan diatur dan TNSNAMES.ORA file terletak di <ORACLE_HOME>/network/admin folder.)
      2. Untuk database kontainer, Anda dapat menyambungkan database akar kontainer menggunakan ID layanan CDB, atau menggunakan nama layanan database yang dapat dicolokkan untuk menyambungkan ke database yang dapat dicolokkan.
    3. Berikan nama pengguna database di bidang Id Pengguna.
    4. Berikan kata sandi database di bidang Kata Sandi .

    Screenshot of connection details.

  3. Pilih Sambungkan.

  4. Sekarang, koneksi baru muncul di menu detail koneksi.

  5. Klik kanan pada koneksi Oracle dan pilih Kelola.

    Screenshot showing the Manage database screen.

  6. Pilih Penilaian Migrasi.

    Screenshot showing the Migration Assessment database screen.

  7. Pilih Jalankan Penilaian baru.

    Screenshot showing the Run new Assessment screen.

  8. Berikan detail penilaian Anda.

    1. Di bidang Nama penilaian, masukkan judul, misalnya, demo1.
    2. Masukkan pengaturan Penilaian Anda.
      1. Masukkan database migrasi tujuan di bidang Platform Target. Saat ini, ini mendukung Azure SQL dan PostgreSQL sebagai target.

        Catatan

        Target PostgreSQL dalam pratinjau. Opsi target ini akan dihentikan. Anda harus mengekspor penilaian sebelumnya.

      2. Di bagian Pengumpulan data performa, pilih Jalankan pengumpulan data performa pada database Oracle (tersambung) atau Tambahkan laporan AWR.

        Rekomendasinya adalah menggunakan opsi terhubung jika Anda menjalankan alat ini selama beban puncak atau realistis. Jika tidak, berikan laporan AWR yang dihasilkan di masa lalu untuk rekomendasi performa dan ukuran.

        Catatan

        Opsi penilaian laporan AWR tidak diaktifkan untuk database yang dapat dicolokkan.

      3. Masukkan nilai pengali di bidang Faktor skala .

        • Jika SKU yang direkomendasikan perlu mempertimbangkan beban puncak lainnya, pengali faktor skala harus lebih besar dari 1. Misalnya, Beban Burst, Penggunaan musiman, dan perencanaan kapasitas di masa mendatang. Ketika beban kerja skema Oracle parsial dimigrasikan, pengali harus kurang dari 1.
      4. Di bidang Pemanfaatan persentil, masukkan nilai persentil untuk mengukur target Azure.

        • Nilai persentil dari sampel performa yang ditetapkan untuk dipertimbangkan untuk mengukur target Azure.

    Screenshot showing the assessment details screen.

  9. Ada dua jenis penilaian:

    • Penilaian Beban Kerja. Dalam penilaian ini, modul penilaian Oracle melakukan penemuan objek skema yang ringan dan mengategorikan kompleksitas skema untuk migrasi ke berbagai kategori dengan perkiraan tingkat tinggi untuk jam konversi. Preassessment ini membantu menemukan kelayakan migrasi ke platform target.

    • Penilaian Kode. Penilaian kode melakukan penilaian mendalam terhadap objek skema Oracle dan kemudian menyarankan kesiapan keseluruhan objek kode dengan jenis objek "siap", "perlu ditinjau", dan "tidak siap" pada tingkat granular dan jam konversi terkait dengan akurasi yang lebih tinggi.

      Catatan

      Ekstensi ini menggunakan pengonversi skema Ora2Pg sumber terbuka untuk penilaian kode.

      Jika klien Oracle dan/atau Ora2Pg tidak diinstal pada komputer yang sama dengan Azure Data Studio, instal secara manual, atau gunakan skrip penginstalan Ora2Pg dari GitHub.

      Jika klien Oracle dan Ora2Pg diinstal, pastikan bahwa jalur beranda klien Oracle, dan jalur penginstalan Ora2Pg diperbarui dalam pengaturan ekstensi.

      • Saat Anda memilih Penilaian kode untuk skenario SQL, pilih skema yang ingin Anda akses untuk Oracle ke konversi dan migrasi SQL. Secara default, semua skema yang memenuhi syarat dipilih untuk penilaian.
  10. Pilih Jalankan validasi untuk melakukan prasyarat dan berbagai aturan validasi yang terkait dengan izin keamanan, pengaturan konfigurasi, dll. Jika validasi gagal, Maka Anda perlu memperbaiki kesalahan untuk melanjutkan lebih lanjut.

  11. Saat Validasi berhasil, Anda dapat memilih Jalankan penilaian.

  12. Sekarang, Anda melihat penilaian baru di bagian "Lima penilaian terakhir".

    Screenshot showing the option to name the assessment.

  13. Pilih tautan penilaian untuk melihat halaman detail penilaian. Anda dapat melihat status penilaian terbaru.

    Screenshot showing the latest assessment status.

  14. Pilih Refresh, atau tunggu hingga penilaian selesai. Secara default, halaman status penilaian di-refresh setiap 15 detik. Status menunjukkan kepada Anda salah satu dari empat status: berhasil, gagal, sedang berlangsung, atau dibatalkan.

Menampilkan penilaian

Setelah penilaian selesai, output terkonsolidasi menggunakan kartu dihasilkan untuk setiap target Azure SQL: SQL Server di Azure Virtual Machines, Azure SQL Database, dan Azure SQL Managed Instance, atau Azure Database for PostgreSQL - Server fleksibel.

Screenshot of the view assessment option.

Setiap kartu memiliki beberapa bagian. Kartu menunjukkan kelayakan keseluruhan migrasi ke target. Anda dapat menelusuri paling detail berbagai beban kerja di bawah berbagai kategori kompleksitas migrasi:

  • Bagian kompatibilitas fitur menyediakan hasil tinjauan penilaian fitur.
  • Rekomendasi SKU memberikan ukuran target yang tepat.
  • Penilaian kode menyediakan kompleksitas kode objek database.

Saat Anda memilih Tampilkan detail laporan, pertama-tama menampilkan ringkasan penilaian.

Screenshot showing assessment summary.

Jika target yang dipilih adalah Database untuk Azure PostgreSQL, tab Detail database atau tab Penilaian kode terlihat berdasarkan pilihan jenis penilaian.

Tab Detail database berikut ini menyediakan perincian per basis skema. Ini menunjukkan daftar skema yang ditemukan, kelayakan migrasi, dan perkiraan waktu untuk mengonversi skema dalam jam.

Screenshot showing the breakdown per schema basis.

Estimasi ini didasarkan pada model statistik yang berlaku untuk jumlah objek, baris kode, fitur yang diaktifkan, dan ukuran database. Untuk perkiraan yang lebih akurat tentang konversi kode, gunakan penilaian kode.

Catatan

Sistem berikut atau skema bawaan Oracle dikecualikan dari penilaian beban kerja:

APEX, APPQOSSYS, AUDSYS, CSMIG, CTXSYS, DBMS_PRIVILEGE_CAPTURE, DBSFWUSER, DBSNMP, DIP, DMSYS, DVF, DVSYS, EXFSYS, FLOW_, GSMADMIN_INTERNAL, LBACSYS, MDDATA, MDSYS, MGDSYS, MGMT_VIEW, MTMSYS, ODM, ODM_MTR, OJVMSYS, OLAPSYS, ORACLE_OCM, ORDDATA, ORDPLUGINS, ORDSYS, OSE$HTTP$ADMIN, OUTLN, OWBSYS, OWBSYS_AUDIT, PERFSTAT, SDE, SI_INFORMTN_SCHEMA, SPATIAL_CSW_ADMIN_USR, SPATIAL_WFS_ADMIN_USR, SQLTXPLAIN, SYS, SYSMAN, SYSTEM, TRACESRV, TSMSYS, WEBSYS, WKPROXY, WKSYS, WK_PROXY, WK_TEST, WMSYS, XDB, XS$NULL

Rekomendasi SKU menyediakan item berikut:

  • Target Azure yang sesuai.

  • Tingkat layanan.

  • Ambang batas metrik digunakan untuk menyediakan SKU yang direkomendasikan.

    Screenshot showing SKU recommendations.

Rekomendasi SKU mengevaluasi berbagai metrik performa, seperti CPU, memori, IOPS, latensi, dan penyimpanan. Berdasarkan penggunaan dan data konfigurasi, pemberi rekomendasi menyediakan target yang sesuai dan tingkat layanan yang sesuai. Rekomendasi SKU didasarkan pada instans akar kontainer atau pemanfaatan database yang dapat dicolokkan. Pemilihan skema diabaikan dan tidak berlaku untuk ukuran SKU.

Catatan

Jika fitur repositori beban kerja otomatis (AWR) diaktifkan pada instans Oracle, pemberi rekomendasi SKU akan menggunakan DBA_HIST_ tampilan untuk mengumpulkan metadata metrik performa. Jika tidak, pemberi rekomendasi akan menggunakan konfigurasi server dan informasi tampilan sistem lainnya untuk mengukur target Azure SQL.

Kompatibilitas kode (hanya untuk target PostgreSQL) menyediakan ringkasan objek skema yang dapat dikonversi ke target Azure. Laporan ini menyediakan pemisahan objek yang dapat dikonversi secara otomatis, siap dengan kondisi, dan perlu diperbaiki dan dikonversi secara manual.

Screenshot showing the code compatibility report.

Laporan menunjukkan jumlah total objek dan jam upaya konversi yang diperlukan untuk memigrasikan kode ke database Azure PostgreSQL. Gambar grafis menyediakan pemisahan untuk setiap jenis objek skema seperti tabel, tampilan, dan kluster. Upaya dikategorikan sebagai "Siap - dikonversi secara otomatis", "Perlu tinjauan", dan "Belum siap - memerlukan konversi manual".

Penelusuran paling detail untuk bagian "Belum siap" dan "Perlu ditinjau" menyediakan daftar tugas remediasi dan jam upaya untuk setiap tugas.

Screenshot showing the remediation task.

Penilaian fitur ini menyediakan fitur yang dipetakan target data Oracle ke Azure dan upaya yang diperlukan untuk memigrasikan kemampuan tersebut ke target Azure.

Screenshot showing the mapped assessment.

Anda dapat mengunduh laporan untuk ditampilkan secara offline dengan memilih Unduh laporan gabungan atau Unduh laporan individual.

Screenshot showing the download assessment report option.

Anda juga dapat membatalkan penilaian yang sedang berlangsung, menghapus penilaian, dan memindahkan penilaian ke direktori lain.

Mengubah jalur penilaian

  1. Buka marketplace ekstensi dan cari Penilaian Migrasi Database untuk Oracle.
  2. Pilih ikon Kelola, dan pilih Pengaturan ekstensi.
  3. Berikan jalur penilaian baru di bawah Penilaian Oracle: Jalur Penilaian.

Screenshot showing the Change assessment path option.

Pemecahan Masalah

Log

Ekstensi menyimpan kesalahan, peringatan, dan log diagnostik lainnya di direktori log default:

  • Windows- C:\Users\<username>.dmaoracle\logs\
  • Linux - ~/.dmaoracle/logs
  • Macos- /Users/<username>/.dmaoracle/logs

Catatan

Secara default, ekstensi menyimpan tujuh file log terakhir.

Untuk mengubah direktori log, perbarui LogDirectory properti dalam file pengaturan ekstensi.

Sistem operasi Jalur
Windows C:\Users\<username>\.azuredatastudio\extensions\microsoft.azuredatastudio-dma-oracle-<VersionNumber>\bin\service\Properties\ConfigSettings\extension-settings.json
Linux ~/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json
macOS /Users/<username>/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json

Untuk informasi selengkapnya tentang pemecahan masalah, kunjungi Memecahkan Masalah Penilaian Migrasi Database untuk kesalahan ekstensi Oracle.

Masalah dan batasan umum

  • Jalur yang disediakan tidak ada.

    Alasan: File hilang atau izin yang hilang pada folder penilaian.

    Solusi yang mungkin:

    • Pengguna memiliki izin baca dan tulis pada folder penilaian.
    • Jika ada file atau folder yang hilang, hapus penilaian dan hasilkan penilaian baru.
  • Mengalami pengecualian batas waktu koneksi saat berinteraksi dengan Oracle.

    Alasan: Gagal tersambung ke instans Oracle.

    Solusi yang mungkin:

    • Periksa apakah aturan firewall memblokir port mendengarkan Oracle.
    • Jalankan tnsping dan lihat apakah ID Layanan diselesaikan.

Hubungi Microsoft untuk bantuan

Jika Anda memerlukan bantuan lebih lanjut dari Microsoft, hubungi @dmasupport. Untuk penyelesaian yang lebih cepat, Anda dapat melampirkan log dari direktori log default.