

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

# Mengonversi kode SQL dalam aplikasi Anda dengan AWS SCT
<a name="CHAP_Converting.App.Generic"></a>

Anda dapat menggunakan AWS SCT untuk mengonversi kode SQL yang disematkan ke dalam aplikasi Anda. Konverter AWS SCT aplikasi generik memperlakukan kode aplikasi Anda sebagai teks biasa. Ini memindai kode aplikasi Anda dan mengekstrak kode SQL dengan ekspresi reguler. Konverter ini mendukung berbagai jenis file kode sumber dan bekerja dengan kode aplikasi yang ditulis dalam bahasa pemrograman apa pun.

Konverter aplikasi generik memiliki batasan berikut. Itu tidak menyelam jauh ke dalam logika aplikasi yang khusus untuk bahasa pemrograman aplikasi Anda. Juga, konverter generik tidak mendukung pernyataan SQL dari objek aplikasi yang berbeda, seperti fungsi, parameter, variabel lokal, dan sebagainya.

Untuk meningkatkan konversi kode SQL aplikasi Anda, gunakan konverter kode SQL aplikasi khusus bahasa. Lihat informasi selengkapnya di [Kode SQL dalam aplikasi C \$1](CHAP_Converting.App.Csharp.md), [Kode SQL di Jawa](CHAP_Converting.App.Java.md), dan [Kode SQL di Pro\$1 C](CHAP_Converting.App.ProC.md).

## Membuat proyek konversi aplikasi generik di AWS SCT
<a name="CHAP_Converting.App.Project"></a>

Dalam AWS Schema Conversion Tool, proyek konversi aplikasi adalah anak dari proyek konversi skema database. Setiap proyek konversi skema database dapat memiliki satu atau lebih proyek konversi aplikasi anak.

**catatan**  
AWS SCT tidak mendukung konversi antara sumber dan target berikut:  
Oracle para Oracle
PostgreSQL ke PostgreSQL atau Aurora PostgreSQL
MySQL ke MySQL
SQL Server ke SQL Server
Amazon Redshift ke Amazon Redshift
SQL Server para Babelfish
Layanan Integrasi SQL Server untuk AWS Glue
Apache Cassandra ke Amazon DynamoDB

 Gunakan prosedur berikut untuk membuat proyek konversi aplikasi generik. 

**Untuk membuat proyek konversi aplikasi**

1. Di dalam AWS Schema Conversion Tool, pilih **Aplikasi generik baru** pada menu **Aplikasi**. 

   Kotak dialog **proyek konversi aplikasi baru** muncul.   
![\[Kotak dialog proyek konversi aplikasi baru\]](http://docs.aws.amazon.com/id_id/SchemaConversionTool/latest/userguide/images/applications-new-project.png)

1. Menambahkan informasi proyek berikut.   
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/SchemaConversionTool/latest/userguide/CHAP_Converting.App.Generic.html)

1. Pilih **Jangan mentransmisikan variabel bind ke tipe SQL** untuk menghindari konversi jenis variabel bind ke tipe SQL. Opsi ini hanya tersedia untuk konversi Oracle ke PostgreSQL.

   Misalnya, kode aplikasi sumber Anda menyertakan kueri Oracle berikut:

   ```
   SELECT * FROM ACCOUNT WHERE id = ?
   ```

   Bila Anda memilih **Jangan mentransmisikan variabel bind ke tipe SQL**, AWS SCT mengkonversi query ini seperti yang ditunjukkan berikut.

   ```
   SELECT * FROM account WHERE id = ?
   ```

   Saat Anda menghapus **Jangan melemparkan variabel bind ke tipe SQL, AWS SCT ubah tipe** variabel bind ke tipe data. `NUMERIC` Hasil konversi ditunjukkan sebagai berikut.

   ```
   SELECT * FROM account WHERE id = (?)::NUMERIC
   ```

1. Pilih **Simpan nama objek** untuk menghindari penambahan nama skema ke nama objek yang dikonversi. Opsi ini hanya tersedia untuk konversi Oracle ke PostgreSQL.

   Misalnya, misalkan kode aplikasi sumber Anda menyertakan kueri Oracle berikut.

   ```
   SELECT * FROM ACCOUNT
   ```

   Saat Anda memilih **Simpan nama objek**, AWS SCT konversi kueri ini seperti yang ditunjukkan berikut.

   ```
   SELECT * FROM account
   ```

   Saat Anda menghapus **nama objek Keep**, AWS SCT tambahkan nama skema ke nama tabel. Hasil konversi ditunjukkan sebagai berikut.

   ```
   SELECT * FROM schema_name.account
   ```

   Jika kode sumber Anda menyertakan nama objek induk dalam nama objek, AWS SCT gunakan format ini dalam kode yang dikonversi. Dalam hal ini, abaikan opsi **Keep object names** karena AWS SCT menambahkan nama objek induk dalam kode yang dikonversi.

1. Pilih **OK** untuk membuat proyek konversi aplikasi Anda. 

   Jendela proyek terbuka.  
![\[Jendela proyek\]](http://docs.aws.amazon.com/id_id/SchemaConversionTool/latest/userguide/images/applications-project-window.png)

## Mengelola proyek konversi aplikasi di AWS SCT
<a name="CHAP_Converting.App.Manage"></a>

Anda dapat membuka proyek konversi aplikasi yang ada dan menambahkan beberapa proyek konversi aplikasi.

Setelah Anda membuat proyek konversi aplikasi, jendela proyek terbuka secara otomatis. Anda dapat menutup jendela proyek konversi aplikasi dan kembali ke sana nanti.

**Untuk membuka proyek konversi aplikasi yang ada**

1. Di panel kiri, pilih node proyek konversi aplikasi, dan buka menu konteks (klik kanan).

1. Pilih **Kelola aplikasi**.

**Untuk menambahkan proyek konversi aplikasi tambahan**

1. Di panel kiri, pilih node proyek konversi aplikasi, dan buka menu konteks (klik kanan).

1. Pilih **Aplikasi baru**.

1. Masukkan informasi yang diperlukan untuk membuat proyek konversi aplikasi baru. Untuk informasi selengkapnya, lihat [Membuat proyek konversi aplikasi generik](#CHAP_Converting.App.Project).

## Menganalisis dan mengonversi kode SQL Anda di AWS SCT
<a name="CHAP_Converting.App.Convert"></a>

Gunakan prosedur berikut untuk menganalisis dan mengonversi kode SQL Anda di file. AWS Schema Conversion Tool

**Untuk menganalisis dan mengonversi kode SQL Anda**

1. Buka proyek konversi aplikasi yang ada, dan pilih **Analisis**. 

   AWS SCT menganalisis kode aplikasi Anda dan mengekstrak kode SQL. AWS SCT menampilkan kode SQL diekstrak dalam daftar skrip **SQL Parsed**. 

1. Untuk **skrip SQL yang diurai**, pilih item untuk meninjau kode SQL yang diekstraksi. AWS SCT menampilkan kode item yang dipilih di panel **skrip SQL yang diekstrak**.

1. Pilih **Mengkonversi** untuk mengonversi kode SQL panel skrip **SQL yang diekstrak**. AWS SCT mengkonversi kode ke format yang kompatibel dengan database target Anda. 

   Anda dapat mengedit kode SQL yang dikonversi. Untuk informasi selengkapnya, lihat [Mengedit dan menyimpan kode SQL Anda yang telah dikonversi](#CHAP_Converting.App.Edit).  
![\[Kode SQL untuk dianalisis\]](http://docs.aws.amazon.com/id_id/SchemaConversionTool/latest/userguide/images/applications-project-analyze.png)

1. Saat Anda membuat laporan penilaian konversi aplikasi, AWS SCT mengonversi semua item kode SQL yang diekstraksi. Untuk informasi selengkapnya, lihat [Membuat dan menggunakan laporan penilaian](#CHAP_Converting.App.AssessmentReport). 

## Membuat dan menggunakan laporan AWS SCT penilaian di AWS SCT
<a name="CHAP_Converting.App.AssessmentReport"></a>

*Laporan penilaian konversi aplikasi* memberikan informasi tentang mengonversi kode SQL aplikasi ke format yang kompatibel dengan basis data target Anda. Laporan ini merinci semua kode SQL yang diekstraksi, semua kode SQL yang dikonversi, dan item tindakan untuk kode SQL yang AWS SCT tidak dapat dikonversi. 

### Membuat laporan penilaian konversi aplikasi
<a name="CHAP_Converting.App.AssessmentReport.Create"></a>

Gunakan prosedur berikut untuk membuat laporan penilaian konversi aplikasi.

**Untuk membuat laporan penilaian konversi aplikasi**

1. Di jendela proyek konversi aplikasi, pilih **Buat laporan** pada menu **Tindakan**. 

   AWS SCT membuat laporan penilaian konversi aplikasi dan membukanya di jendela proyek konversi aplikasi. 

1. Tinjau tab **Ringkasan**. 

   Tab **Ringkasan**, ditampilkan berikut, menampilkan informasi ringkasan dari laporan penilaian aplikasi. Ini menunjukkan item kode SQL yang dikonversi secara otomatis, dan item yang tidak dikonversi secara otomatis.   
![\[Tab ringkasan Laporan Penilaian Aplikasi\]](http://docs.aws.amazon.com/id_id/SchemaConversionTool/latest/userguide/images/applications-summary.png)

1. Pilih **tindakan ekstraksi SQL**. 

   Tinjau daftar item kode SQL yang tidak AWS SCT dapat mengekstrak dari kode sumber Anda. 

1. Pilih **tindakan konversi SQL**. 

   Tinjau daftar item kode SQL yang tidak AWS SCT dapat dikonversi secara otomatis. Gunakan tindakan yang disarankan untuk mengonversi kode SQL secara manual. Untuk informasi tentang cara mengedit kode SQL yang dikonversi, lihat[Mengedit dan menyimpan kode SQL Anda yang dikonversi dengan AWS SCT](#CHAP_Converting.App.Edit). 

1. (Opsional) Simpan salinan laporan lokal sebagai file PDF atau file nilai yang dipisahkan koma (CSV):
   + Pilih **Simpan ke PDF** di kanan atas untuk menyimpan laporan sebagai file PDF.

      File PDF berisi ringkasan eksekutif, item tindakan, dan rekomendasi untuk konversi aplikasi.
   + Pilih **Simpan ke CSV** di kanan atas untuk menyimpan laporan sebagai file CSV.

     File CSV berisi item tindakan, tindakan yang direkomendasikan, dan perkiraan kompleksitas upaya manual yang diperlukan untuk mengonversi kode SQL.

## Mengedit dan menyimpan kode SQL Anda yang dikonversi dengan AWS SCT
<a name="CHAP_Converting.App.Edit"></a>

Laporan penilaian menyertakan daftar item kode SQL yang tidak AWS SCT dapat dikonversi. Untuk setiap item, AWS SCT buat item tindakan di tab **tindakan konversi SQL**. Untuk item ini, Anda dapat mengedit kode SQL secara manual untuk melakukan konversi. 

Gunakan prosedur berikut untuk mengedit kode SQL Anda yang telah dikonversi, menerapkan perubahan, dan kemudian menyimpannya. 

**Untuk mengedit, menerapkan perubahan ke, dan menyimpan kode SQL Anda yang telah dikonversi**

1. Edit kode SQL Anda yang dikonversi secara langsung di panel **skrip Target SQL**. Jika tidak ada kode yang dikonversi yang ditampilkan, Anda dapat mengklik panel dan mulai mengetik. 

1. Setelah Anda selesai mengedit kode SQL yang dikonversi, pilih **Terapkan**. Pada titik ini, perubahan disimpan dalam memori, tetapi belum ditulis ke file Anda. 

1. Pilih **Simpan** untuk menyimpan perubahan ke file Anda. 

   Ketika Anda memilih **Simpan**, Anda menimpa file asli Anda. Buat salinan file asli Anda sebelum menyimpan sehingga Anda memiliki catatan kode aplikasi asli Anda. 