View a markdown version of this page

Koneksi Azure SQL - AWS Lem
Mengkonfigurasi Azure SQLBaca dari Azure SQLMenulis ke Azure SQLReferensi opsi koneksi Azure SQL

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

Koneksi Azure SQL

Anda dapat menggunakan AWS Glue for Spark untuk membaca dan menulis ke tabel di Azure SQL Managed Instances di AWS Glue 4.0 dan versi yang lebih baru. Anda dapat menentukan apa yang akan dibaca dari Azure SQL dengan kueri SQL. Anda terhubung ke Azure SQL menggunakan kredensional pengguna dan kata sandi yang disimpan AWS Secrets Manager melalui koneksi AWS Glue.

Untuk informasi selengkapnya tentang Azure SQL, lihat dokumentasi Azure SQL.

Mengkonfigurasi koneksi Azure SQL

Untuk terhubung ke Azure SQL dari AWS Glue, Anda harus membuat dan menyimpan kredenSIAL Azure SQL Anda secara AWS Secrets Manager rahasia, lalu mengaitkan rahasia itu dengan koneksi Azure SQL AWS Glue.

Untuk mengkonfigurasi koneksi ke Azure SQL:

  1. Di AWS Secrets Manager, buat rahasia menggunakan kredentif Azure SQL Anda. Untuk membuat rahasia di Secrets Manager, ikuti tutorial yang tersedia di Buat AWS Secrets Manager rahasia dalam AWS Secrets Manager dokumentasi. Setelah membuat rahasia, simpan nama Rahasia, secretName untuk langkah selanjutnya.

    • Saat memilih Key/value pasangan, buat pasangan untuk kunci user dengan nilaiazuresqlUsername.

    • Saat memilih Key/value pasangan, buat pasangan untuk kunci password dengan nilainyaazuresqlPassword.

  2. Di konsol AWS Glue, buat koneksi dengan mengikuti langkah-langkah diMenambahkan AWS Glue koneksi. Setelah membuat koneksi, simpan nama koneksi,connectionName, untuk digunakan di masa mendatang di AWS Glue.

    • Saat memilih jenis koneksi, pilih Azure SQL.

    • Saat menyediakan URL Azure SQL, berikan URL titik akhir JDBC.

      URL harus dalam format berikut:jdbc:sqlserver://databaseServerName:databasePort;databaseName=azuresqlDBname;.

      AWS Lem membutuhkan properti URL berikut:

      • databaseName- Basis data default di Azure SQL untuk terhubung.

      Untuk informasi selengkapnya tentang URL JDBC untuk Azure SQL Managed Instances, lihat dokumentasi Microsoft.

    • Saat memilih AWS Rahasia, berikansecretName.

Setelah membuat koneksi AWS Glue Azure SQL, Anda harus melakukan langkah-langkah berikut sebelum menjalankan pekerjaan AWS Glue Anda:

  • Berikan peran IAM yang terkait dengan izin pekerjaan AWS Glue Anda untuk membacasecretName.

  • Dalam konfigurasi pekerjaan AWS Glue Anda, berikan connectionName sebagai koneksi jaringan tambahan.

Membaca dari tabel Azure SQL

Prasyarat:

  • Tabel Azure SQL yang ingin Anda baca. Anda akan memerlukan informasi identifikasi untuk tabel, databaseName dantableIdentifier.

    Tabel Azure SQL diidentifikasi oleh database, skema dan nama tabelnya. Anda harus memberikan nama database dan nama tabel saat menghubungkan ke Azure SQL. Anda juga harus memberikan skema jika bukan default, “publik”. Basis data disediakan melalui properti URL diconnectionName, skema dan nama tabel melaluidbtable.

  • Koneksi AWS Glue Azure SQL dikonfigurasi untuk memberikan informasi autentikasi. Selesaikan langkah-langkah dalam prosedur sebelumnya, Untuk mengkonfigurasi koneksi ke Azure SQL untuk mengonfigurasi informasi autentikasi Anda. Anda akan membutuhkan nama koneksi AWS Glue,connectionName.

Contoh: 

azuresql_read_table = glueContext.create_dynamic_frame.from_options(
    connection_type="azuresql",
    connection_options={
        "connectionName": "connectionName",
        "dbtable": "tableIdentifier"
    }
)

Anda juga dapat memberikan kueri SELECT SQL, untuk memfilter hasil yang dikembalikan ke Anda DynamicFrame. Anda perlu mengkonfigurasiquery.

Contoh:

azuresql_read_query = glueContext.create_dynamic_frame.from_options(
    connection_type="azuresql",
    connection_options={
        "connectionName": "connectionName",
        "query": "query"
    }
)

Menulis ke tabel Azure SQL

Contoh ini menulis informasi dari yang sudah ada DynamicFrame, dynamicFrame ke Azure SQL. Jika tabel sudah memiliki informasi, AWS Glue akan menambahkan data dari Anda DynamicFrame.

Prasyarat:

  • Tabel Azure SQL yang ingin Anda tulis. Anda akan memerlukan informasi identifikasi untuk tabel, databaseName dantableIdentifier.

    Tabel Azure SQL diidentifikasi oleh database, skema dan nama tabelnya. Anda harus memberikan nama database dan nama tabel saat menghubungkan ke Azure SQL. Anda juga harus memberikan skema jika bukan default, “publik”. Basis data disediakan melalui properti URL diconnectionName, skema dan nama tabel melaluidbtable.

  • Informasi autentikasi Azure SQL. Selesaikan langkah-langkah dalam prosedur sebelumnya, Untuk mengkonfigurasi koneksi ke Azure SQL untuk mengonfigurasi informasi autentikasi Anda. Anda akan membutuhkan nama koneksi AWS Glue,connectionName.

Contoh: 

azuresql_write = glueContext.write_dynamic_frame.from_options(
    connection_type="azuresql",
    connection_options={
        "connectionName": "connectionName",
        "dbtable": "tableIdentifier"
    }
)

Referensi opsi koneksi Azure SQL

  • connectionName — Diperlukan. Digunakan untuk Read/Write. Nama koneksi AWS Glue Azure SQL dikonfigurasi untuk memberikan informasi autentikasi ke metode koneksi Anda.

  • databaseName— Digunakan untuk Read/Write. Nilai yang Valid: Nama database Azure SQL. Nama database di Azure SQL untuk terhubung.

  • dbtable- Diperlukan untuk menulis, diperlukan untuk membaca kecuali query disediakan. Digunakan untuk Read/Write. Nilai Valid: Nama tabel Azure SQL, atau kombinasi schema/table nama yang dipisahkan periode. Digunakan untuk menentukan tabel dan skema yang mengidentifikasi tabel untuk terhubung. Skema default adalah “publik”. Jika tabel Anda berada dalam skema non-default, berikan informasi ini dalam formulirschemaName.tableName.

  • query— Digunakan untuk membaca. Kueri SEL Transact-SQL ECT mendefinisikan apa yang harus diambil saat membaca dari Azure SQL. Untuk informasi selengkapnya, lihat dokumentasi Microsoft.