Bagikan melalui

Menjalankan Konsol SSMA (SybaseToSQL)

  • Artikel

Microsoft memberi Anda sekumpulan perintah file skrip yang kuat untuk menjalankan dan mengontrol aktivitas SSMA. Bagian berikutnya merinci hal yang sama.

Perintah file skrip

Aplikasi konsol menggunakan perintah file skrip standar tertentu seperti yang dijumlahkan di bagian ini.

Perintah proyek

Perintah Proyek menangani pembuatan proyek, membuka, menyimpan, dan keluar dari proyek.

create-new-project

Perintah ini membuat proyek SSMA baru.

  • project-folder menunjukkan folder proyek yang dibuat.

  • project-name menunjukkan nama proyek. {string}

  • overwrite-if-existsAtribut opsional menunjukkan apakah proyek yang ada harus ditimpa. {boolean}

  • project-type:Atribut opsional. Menunjukkan jenis proyek, yaitu proyek "sql-server-2005" atau proyek "sql-server-2008" atau proyek "sql-server-2012" atau proyek "sql-server-2014" atau proyek "sql-azure". Defaultnya adalah "sql-server-2008."

Contoh sintaks:

<create-new-project  
  
  project-folder="<project-folder>"  
  
  project-name="<project-name>"  
  
  overwrite-if-exists="<true/false>" (optional)  
  
   project-type="<sql-server-2008/sql-server-2005/sql-server-2012/sql-server-2014/sql-azure>"  
/>

Atribut 'overwrite-if-exists' adalah false secara default.

Atribut 'project-type' adalah sql-server-2008 secara default.

proyek terbuka

Perintah ini membuka proyek.

  • project-folder menunjukkan folder proyek yang dibuat. Perintah gagal jika folder yang ditentukan tidak ada. {string}

  • project-name menunjukkan nama proyek. Perintah gagal jika proyek yang ditentukan tidak ada. {string}

Contoh sintaks:

<open-project  
  
  project-folder="<project-folder>"  
  
  project-name="<project-name>"  
  
/>

Catatan

SSMA untuk Aplikasi Konsol SAP ASE mendukung kompatibilitas mundur. Anda dapat menggunakannya untuk membuka proyek yang dibuat oleh versi SSMA sebelumnya.

save-project

Perintah ini menyimpan proyek migrasi.

Contoh sintaks:

<save-project/>

close-project

Perintah ini menutup proyek migrasi.

Contoh sintaks:

<close-project   
  if-modified="<save/error/ignore>"   (optional)  
/>

Atribut 'if-modified' bersifat opsional, abaikan secara default.

Perintah Koneksi Database

Perintah Koneksi Database membantu menyambungkan ke database.

Catatan

connect-source-database

Perintah ini melakukan koneksi ke database sumber dan memuat metadata tingkat tinggi database sumber, tetapi tidak semua metadata.

Jika koneksi ke sumber tidak dapat dibuat, kesalahan dihasilkan dan aplikasi konsol menghentikan eksekusi lebih lanjut.

Definisi server diambil dari atribut nama yang ditentukan untuk setiap koneksi di bagian server file koneksi server atau file skrip.

Contoh sintaks:

<connect-source-database  server="<server-unique-name>"/>

force-load-source/target-database

Perintah ini memuat metadata sumber, dan berguna untuk mengerjakan proyek migrasi secara offline.

Jika koneksi ke sumber/target tidak dapat dibuat, kesalahan dihasilkan dan aplikasi konsol menghentikan eksekusi lebih lanjut.

Perintah ini memerlukan satu atau beberapa simpul metabase sebagai parameter baris perintah.

Contoh sintaks:

<force-load metabase="<source/target>" >  
  
  <metabase-object object-name="<object-name>"/>  
  
</force-load>

reconnect-source-database

Perintah ini terhubung kembali ke database sumber tetapi tidak memuat metadata apa pun tidak seperti perintah connect-source-database.

Jika (re)koneksi dengan sumber tidak dapat dibuat, kesalahan dihasilkan dan aplikasi konsol menghentikan eksekusi lebih lanjut.

Contoh sintaks:

<reconnect-source-database  server="<server-unique-name>"/>

connect-target-database

Perintah ini tersambung ke database SQL Server target dan memuat metadata tingkat tinggi dari database target tetapi bukan metadata sepenuhnya.

Jika koneksi ke target tidak dapat dibuat, kesalahan dihasilkan dan aplikasi konsol menghentikan eksekusi lebih lanjut.

Definisi server diambil dari atribut nama yang ditentukan untuk setiap koneksi di bagian server file koneksi server atau file skrip.

Contoh sintaks:

<connect-target-database  server="<server-unique-name>"/>

reconnect-target-database

Perintah ini terhubung kembali ke database target tetapi tidak memuat metadata apa pun, tidak seperti perintah connect-target-database.

Jika (re)koneksi ke target tidak dapat dibuat, kesalahan dihasilkan dan aplikasi konsol menghentikan eksekusi lebih lanjut.

Contoh sintaks:

<reconnect-target-database  server="<server-unique-name>"/>

Perintah laporan

Perintah Laporan menghasilkan laporan tentang performa berbagai aktivitas Konsol SSMA.

generate-assessment-report

Perintah ini menghasilkan laporan penilaian pada database sumber.

Jika koneksi database sumber tidak dilakukan sebelum menjalankan perintah ini, kesalahan dihasilkan dan aplikasi konsol keluar.

Kegagalan untuk menyambungkan ke server database sumber selama eksekusi perintah, juga menghasilkan penghentian aplikasi konsol.

  • conversion-report-folder: Menentukan folder tempat laporan penilaian dapat disimpan. (atribut opsional)

  • object-name: Menentukan objek yang dipertimbangkan untuk pembuatan laporan penilaian (mendukung nama objek individual atau nama objek grup).

  • object-type: Menentukan jenis objek yang dipanggil dalam atribut nama objek (jika kategori objek ditentukan, maka jenis objek akan menjadi "kategori").

  • conversion-report-overwrite: Menentukan apakah akan menimpa folder laporan penilaian jika sudah ada.

    Nilai default: false. (atribut opsional)

  • write-summary-report-to: Menentukan jalur di mana laporan akan dibuat.

    Jika hanya jalur folder yang disebutkan, maka file menurut nama AssessmentReport<n.XML> dibuat. (atribut opsional)

    Pembuatan laporan memiliki dua subkataan lebih lanjut:

    • report-errors (="true/false", dengan default sebagai "false" (atribut opsional))

    • verbose (="true/false", dengan default sebagai "false" (atribut opsional))

Contoh sintaks:

<generate-assessment-report  
  
  object-name="<object-name>"  
  
  object-type="<object-category>"  
  
  write-summary-report-to="<file-name/folder-name>"             (optional)  
  
  verbose="<true/false>"                       (optional)  
  
  report-errors="<true/false>"                 (optional)  
  
  assessment-report-folder="<folder-name>"          (optional)  
  
  conversion-report-overwrite="<true/false>"   (optional)  
  
/>

atau

<generate-assessment-report  
  
  assessment-report-folder="<folder-name>"            (optional)  
  
  conversion-report-overwrite="<true/false>"     (optional)  
  
>  
<metabase-object object-name="<object-name>"  
  
        object-type="<object-category>"/>  
  
</generate-assessment-report>

Perintah migrasi

Perintah Migrasi mengonversi skema database target ke skema sumber dan memigrasikan data ke server target.

convert-schema

Perintah ini melakukan konversi skema dari sumber ke skema target.

Jika koneksi database sumber atau target tidak dilakukan sebelum menjalankan perintah ini atau koneksi ke server database sumber atau target gagal selama eksekusi perintah, kesalahan dihasilkan dan aplikasi konsol keluar.

  • conversion-report-folder: Menentukan folder tempat laporan penilaian dapat disimpan. (atribut opsional)

  • object-name: Menentukan objek sumber yang dipertimbangkan untuk mengonversi skema (mendukung nama objek individual atau nama objek grup).

  • object-type: Menentukan jenis objek yang dipanggil dalam atribut nama objek (jika kategori objek ditentukan, maka jenis objek akan menjadi "kategori").

  • conversion-report-overwrite: Menentukan apakah akan menimpa folder laporan penilaian jika sudah ada.

    Nilai default: false. (atribut opsional)

  • write-summary-report-to: Menentukan jalur di mana laporan ringkasan akan dibuat.

    Jika hanya jalur folder yang disebutkan, maka file menurut nama SchemaConversionReport<n.XML> dibuat. (atribut opsional)

    Pembuatan laporan memiliki dua subkataan lebih lanjut:

    • report-errors (="true/false", dengan default sebagai "false" (atribut opsional))

    • verbose (="true/false", dengan default sebagai "false" (atribut opsional))

Contoh sintaks:

<convert-schema  
  
  object-name="<object-name>"  
  
  object-type="<object-category>"  
  write-summary-report-to="<file-name/folder-name>"     (optional)  
  
  verbose="<true/false>"                          (optional)  
  
  report-errors="<true/false>"                    (optional)  
  
  conversion-report-folder="<folder-name>"             (optional)  
  
  conversion-report-overwrite="<true/false>"      (optional)  
  
/>

atau

<convert-schema  
  
  conversion-report-folder="<folder-name>"         (optional)  
  
  conversion-report-overwrite="<true/false>"> (optional)  
  
  <metabase-object object-name="<object-name>"  
  
    object-type="<object-category>"/>  
  
</convert-schema>

data migrasi

Perintah ini memigrasikan data sumber ke target.

  • object-name: Menentukan objek sumber yang dipertimbangkan untuk memigrasikan data (mendukung nama objek individual atau nama objek grup).

  • object-type: menentukan jenis objek yang dipanggil dalam atribut nama objek (jika kategori objek ditentukan maka jenis objek akan menjadi "kategori").

  • write-summary-report-to: Menentukan jalur di mana laporan akan dibuat.

    Jika hanya jalur folder yang disebutkan, maka file menurut nama DataMigrationReport<n.XML> dibuat. (atribut opsional)

    Pembuatan laporan memiliki dua subkataan lebih lanjut:

    • report-errors (="true/false", dengan default sebagai "false" (atribut opsional))

    • verbose (="true/false", dengan default sebagai "false" (atribut opsional))

Contoh sintaks:

<migrate-data  
  
  write-summary-report-to="<file-name/folder-name>"  
  
  report-errors="<true/false>" verbose="<true/false>">  
  
    <metabase-object object-name="<object-name>"/>  
  
    <metabase-object object-name="<object-name>"/>  
  
    <metabase-object object-name="<object-name>"/>  
  
    <data-migration-connection  
  
      source-use-last-used="true"/source-server="<server-unique-name>"  
  
      target-use-last-used="true"/target-server="<server-unique-name>"/>  
  
</migrate-data>

atau

<migrate-data  
  
  object-name="<object-name>"  
  
  object-type="<object-category>"  
  
  write-summary-report-to="<file-name/folder-name>"  
  
  report-errors="<true/false>" verbose="<true/false>"/>

Perintah Persiapan Migrasi

Perintah Persiapan Migrasi memulai pemetaan skema antara database sumber dan target.

Catatan

Pengaturan output konsol default untuk perintah migrasi adalah laporan output 'Penuh' tanpa pelaporan kesalahan terperinci: Hanya ringkasan pada simpul akar pohon objek sumber.

skema peta

Perintah ini menyediakan pemetaan skema database sumber ke skema target.

  • source-schema Menentukan skema sumber yang akan dimigrasikan.

  • sql-server-schema Menentukan skema target tempat skema sumber akan dimigrasikan.

Contoh sintaks:

<map-schema source-schema="<source-schema>"  
  
sql-server-schema="<target-schema>"/>

Perintah pengelolaan

Perintah Pengelolaan membantu menyinkronkan objek database target dengan database sumber.

Catatan

Pengaturan output konsol default untuk perintah migrasi adalah laporan output 'Penuh' tanpa pelaporan kesalahan terperinci: Hanya ringkasan pada simpul akar pohon objek sumber.

synchronize-target

Perintah ini menyinkronkan objek target dengan database target.

Jika perintah ini dijalankan terhadap database sumber, terjadi kesalahan.

Jika koneksi database target tidak dilakukan sebelum menjalankan perintah ini atau koneksi ke server database target gagal selama eksekusi perintah, kesalahan dihasilkan dan aplikasi konsol keluar.

  • object-name: Menentukan objek target yang dipertimbangkan untuk disinkronkan dengan database target (mendukung nama objek individual atau nama objek grup).

  • object-type: Menentukan jenis objek yang dipanggil dalam atribut nama objek (jika kategori objek ditentukan maka jenis objek akan menjadi "kategori").

  • on-error: Menentukan apakah akan menentukan kesalahan sinkronisasi sebagai peringatan atau kesalahan. Opsi yang tersedia untuk kesalahan:

    • report-total-as-warning

    • report-each-as-warning

    • fail-script

  • report-errors-to: Menentukan lokasi laporan kesalahan untuk operasi sinkronisasi (atribut opsional). Jika hanya jalur folder yang diberikan, maka file berdasarkan nama TargetSynchronizationReport.XML dibuat.

Contoh sintaks:

<synchronize-target  
  
object-name="<object-name>"  
  
on-error="<report-total-as-warning/  
  
report-each-as-warning/  
  
fail-script>" (optional)  
  
  report-errors-to="<file-name/folder-name>"        (optional)  
  
/>

atau

<synchronize-target  
  
  object-name="<object-name>"  
  
  object-type="<object-category>"/>

atau

<synchronize-target>  
  
  <metabase-object object-name="<object-name>"/>  
  
  <metabase-object object-name="<object-name>"/>  
  
  <metabase-object object-name="<object-name>"/>  
  
</synchronize-target>

refresh-from-database

Perintah ini me-refresh objek sumber dari database.

Jika perintah ini dijalankan terhadap database target, kesalahan akan dihasilkan.

Perintah ini memerlukan satu atau beberapa simpul metabase sebagai parameter baris perintah.

  • object-name: Menentukan objek sumber yang dipertimbangkan untuk refresh dari database sumber (mendukung nama objek individual atau nama objek grup).

  • object-type: Menentukan jenis objek yang ditentukan dalam atribut nama objek (jika kategori objek ditentukan maka jenis objek akan menjadi "kategori").

  • on-error: Menentukan apakah akan memanggil kesalahan refresh sebagai peringatan atau kesalahan. Opsi yang tersedia untuk kesalahan:

    • report-total-as-warning

    • report-each-as-warning

    • fail-script

  • report-errors-to: Menentukan lokasi laporan kesalahan untuk operasi refresh (atribut opsional). Jika hanya jalur folder yang diberikan, maka file menurut nama SourceDBRefreshReport.XML dibuat.

Contoh sintaks:

<refresh-from-database  
  
  object-name="<object-name>"  
  
  on-error="<report-total-as-warning/  
  
             report-each-as-warning/  
  
             fail-script>"              (optional)  
  
  report-errors-to="<file-name/folder-name>"        (optional)  
  
/>

atau

<refresh-from-database  
  
  object-name="<object-name>"  
  
  object-type="<object-category>" />

atau

<refresh-from-database>  
  
  <metabase-object object-name="<object-name>"/>  
  
</refresh-from-database>

Perintah Pembuatan Skrip

Perintah Pembuatan Skrip melakukan tugas ganda: perintah tersebut membantu menyimpan output konsol dalam file skrip, dan mereka merekam output T-SQL ke konsol atau file berdasarkan parameter yang Anda tentukan.

simpan sebagai skrip

Perintah ini digunakan untuk menyimpan Skrip objek ke file yang disebutkan saat metabase=target. Ini adalah alternatif untuk perintah sinkronisasi karena kita mendapatkan skrip dan menjalankan hal yang sama pada database target.

Perintah ini memerlukan satu atau beberapa simpul metabase sebagai parameter baris perintah.

  • object-name: Menentukan objek yang skripnya akan disimpan (mendukung nama objek individual atau nama objek grup).

  • object-type: Menentukan jenis objek yang dipanggil dalam atribut nama objek (jika kategori objek ditentukan, maka jenis objek akan menjadi "kategori").

  • metabase: Menentukan apakah itu metabase sumber atau target.

  • destination: Menentukan jalur atau folder tempat skrip harus disimpan. Jika nama file tidak diberikan, maka nama file dalam format (object_name nilai atribut).out akan disediakan.

  • overwrite: Jika true, maka akan menimpa nama file yang sama jika ada. Ini dapat memiliki nilai (benar/salah).

Contoh sintaks:

<save-as-script  
  
  metabase="<source/target>"  
  
  object-name="<object-name>"  
  
  object-type="<object-category>"  
  
  destination="<file-name/folder-name>"  
  
  overwrite="<true/false>"   (optional)  
  
/>

atau

<save-as-script  
  
  metabase="<source/target>"  
  
  destination="<file-name/folder-name>"  
  
    <metabase-object object-name="<object-name>"  
  
                     object-type="<object-category>"/>  
  
</save-as-script>

convert-sql-statement

Perintah ini mengonversi pernyataan SQL.

  • context Menentukan nama skema.

  • destination Menentukan apakah output harus disimpan dalam file.

    Jika atribut ini tidak ditentukan, maka pernyataan T-SQL yang dikonversi ditampilkan di konsol. (atribut opsional)

  • conversion-report-folder Menentukan folder tempat laporan penilaian dapat disimpan. (atribut opsional)

  • conversion-report-overwrite Menentukan apakah akan menimpa folder laporan penilaian jika sudah ada.

    Nilai default: false. (atribut opsional)

  • write-converted-sql-to menentukan jalur folder file (atau) tempat T-SQL yang dikonversi harus disimpan. Ketika jalur folder ditentukan bersama dengan sql-files atribut , setiap file sumber memiliki file T-SQL target yang sesuai yang dibuat di bawah folder yang ditentukan. Ketika jalur folder ditentukan bersama dengan sql atribut , T-SQL yang dikonversi ditulis ke file bernama Result.out di bawah folder yang ditentukan.

  • sql menentukan pernyataan Sybase sql yang akan dikonversi, satu atau beberapa pernyataan dapat dipisahkan menggunakan ";"

  • sql-files menentukan jalur file sql yang harus dikonversi ke kode T-SQL.

  • write-summary-report-to menentukan jalur di mana laporan ringkasan akan dibuat. Jika hanya jalur folder yang disebutkan, maka file menurut nama ConvertSQLReport.XML dibuat. (atribut opsional)

    Pembuatan laporan ringkasan memiliki dua subkategori lebih lanjut, yaitu:

    • report-errors (="true/false", dengan default sebagai "false" (atribut opsional)).

    • verbose (="true/false", dengan default sebagai "false" (atribut opsional)).

Perintah ini memerlukan satu atau beberapa simpul metabase sebagai parameter baris perintah.

Contoh sintaks:

<convert-sql-statement  
  
       context="<database-name>.<schema-name>"  
  
        conversion-report-folder="<folder-name>"  
  
        conversion-report-overwrite="<true/false>"  
  
        write-summary-report-to="<file-name/folder-name>"   (optional)  
  
        verbose="<true/false>"   (optional)  
  
        report-errors="<true/false>"   (optional)  
  
        destination="<stdout/file>"   (optional)  
  
        write-converted-sql-to ="<file-name/folder-name>"  
  
        sql="SELECT 1 FROM DUAL;">  
  
    <output-window suppress-messages="<true/false>" />  
  
</convert-sql-statement>

atau

<convert-sql-statement  
  
         context="<database-name>.<schema-name>"  
  
         conversion-report-folder="<folder-name>"  
  
         conversion-report-overwrite="<true/false>"  
  
         write-summary-report-to="<file-name/folder-name>"   (optional)  
  
         verbose="<true/false>"   (optional)  
  
         report-errors="<true/false>"   (optional)  
  
         destination="<stdout/file>"   (optional)  
  
         write-converted-sql-to ="<file-name/folder-name>"  
  
         sql-files="<folder-name>\*.sql"  
  
/>

atau

<convert-sql-statement  
  
         context="<database-name>.<schema-name>"  
  
         conversion-report-folder="<folder-name>"  
  
         conversion-report-overwrite="<true/false>"  
  
         sql-files="<folder-name>\*.sql"  
  
/>

Langkah berikutnya

Untuk informasi tentang opsi baris perintah, lihat Opsi baris perintah di Konsol SSMA (AccessToSQL).

Untuk informasi tentang contoh file skrip konsol, lihat Bekerja dengan File Skrip Konsol Sampel (SybaseToSQL)

Langkah selanjutnya tergantung pada persyaratan proyek Anda: