Menghubungkan ke Cloud SQL untuk SQL Server menggunakan Proxy Auth Cloud SQL

Menghubungkan ke Cloud SQL untuk SQL Server menggunakan Proxy Auth Cloud SQL

MySQL   |  PostgreSQL   |  SQL Server

Halaman ini menunjukkan cara terhubung ke Cloud SQL dari lingkungan pengujian lokal menggunakan Cloud SQL Auth Proxy. Proxy Auth Cloud SQL memberikan akses yang aman ke instance Cloud SQL Anda tanpa memerlukan jaringan yang diizinkan atau konfigurasi SSL. Dengan menggunakan Cloud SQL Auth Proxy, Anda dapat terhubung ke instance Cloud SQL dengan aman.

Petunjuk di halaman ini hanya untuk lingkungan pengujian dan tidak boleh digunakan untuk lingkungan produksi. Untuk informasi selengkapnya tentang konfigurasi yang diperlukan untuk lingkungan produksi, lihat Menggunakan Proxy Auth Cloud SQL di lingkungan produksi dan Menghubungkan menggunakan Proxy Auth Cloud SQL.

Sebelum memulai

Catatan: Nama yang Anda gunakan untuk project harus terdiri dari 4 hingga 30 karakter. Saat Anda mengetik nama tersebut, formulir akan menyarankan project ID yang dapat Anda edit. Project ID harus terdiri dari 6 hingga 30 karakter, dengan huruf kecil sebagai karakter pertama. Anda dapat menggunakan tanda pisah, huruf kecil, atau angka untuk karakter yang tersisa, tetapi karakter terakhir tidak boleh berupa tanda pisah.

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Mengaktifkan Google Cloud API yang diperlukan.

   Konsol

   Di konsol Google Cloud , buka halaman APIs.

   Buka API

   Mengaktifkan Cloud SQL Admin API.

   gcloud

   Klik tombol berikut untuk membuka Cloud Shell, yang menyediakan akses command line ke resource Google Cloud langsung dari browser. Cloud Shell dapat digunakan untuk menjalankan perintah gcloud yang disajikan di seluruh panduan memulai ini.

   Buka Cloud Shell

   Jalankan perintah gcloud services enable sebagai berikut menggunakan Cloud Shell untuk mengaktifkan API yang diperlukan untuk panduan memulai ini.:

   gcloud services enable sqladmin.googleapis.com

   Perintah ini mengaktifkan API berikut:

   • Cloud SQL Admin API

4. Pastikan Anda memiliki peran berikut pada project: Admin Cloud SQL (roles/cloudsql.admin)

   Memeriksa peran

   1. Di konsol Google Cloud , buka halaman IAM.

      Buka IAM
   2. Pilih project.

   3. Di kolom Principal, temukan semua baris yang mengidentifikasi Anda atau grup yang mencakup Anda. Untuk mengetahui grup tempat Anda disertakan, hubungi administrator Anda.

   4. Untuk semua baris yang menentukan atau menyertakan Anda, periksa kolom Peran untuk melihat apakah daftar peran menyertakan peran yang diperlukan.

   Memberikan peran

   1. Di konsol Google Cloud , buka halaman IAM.

      Buka IAM
   2. Pilih project.
   3. Klik Grant access.

   4. Di kolom New principals, masukkan ID pengguna Anda. Biasanya, ini adalah ID untuk pengguna dalam workforce identity pool. Untuk mengetahui detailnya, baca bagian Merepresentasikan pengguna workforce pool dalam kebijakan IAM, atau hubungi administrator Anda.

   5. Klik Select a role, lalu telusuri peran.
   6. Untuk memberikan peran tambahan, klik Add another role, lalu tambahkan tiap peran tambahan.
   7. Klik Simpan.
5. Menginstal dan melakukan inisialisasi gcloud CLI.

Membuat instance Cloud SQL

Dalam panduan memulai ini, Anda akan menggunakan konsol Google Cloud . Untuk menggunakan gcloud CLI, curl, atau PowerShell, lihat Membuat instance.

1. Di konsol Google Cloud , buka halaman Instance Cloud SQL.

   Buka Instance Cloud SQL

2. Klik Create instance.
3. Dari menu Create instance, pilih New instance.
4. Klik Pilih SQL Server.
5. Di kolom Instance ID, masukkan myinstance.
6. Di kolom Password, masukkan sandi untuk pengguna sqlserver.

7. Klik Create instance.

   Anda akan kembali ke daftar instance. Anda dapat langsung mengklik instance baru untuk melihat detailnya, tetapi instance tidak akan tersedia untuk operasi lain sampai instance melakukan inisialisasi dan dimulai.

   Catatan: Dalam contoh ini, instance dibuat menggunakan setelan default, termasuk alamat IP publik.

Debian/Ubuntu

Untuk Debian/Ubuntu, instal alat command line SQL Server yang berlaku menggunakan petunjuk ini.

CentOS/RHEL

Untuk CentOS/RHEL, instal alat command line SQL Server yang berlaku menggunakan petunjuk ini.

openSUSE

Untuk openSUSE, instal alat command line SQL Server yang berlaku menggunakan petunjuk ini.

Platform lainnya

Lihat halaman landing untuk menginstal SQL Server, serta halaman download SQL Server.

Menginstal klien Cloud SQL Auth Proxy

Untuk penginstalan, lihat Menginstal Cloud SQL Auth Proxy.

Mendapatkan nama koneksi instance

1. Di konsol Google Cloud , buka halaman Instance Cloud SQL.

   Buka Instance Cloud SQL

2. Klik nama instance untuk membuka halaman Ringkasan.
3. Di bagian Terhubung ke instance ini, salin Nama koneksi. Nama koneksi dalam format projectID:region:instanceID.

Memulai Proxy Auth Cloud SQL

Cloud SQL Auth Proxy menggunakan Kredensial Default Aplikasi (ADC) untuk melakukan autentikasi ke Google Cloud. Untuk informasi selengkapnya, lihat Opsi untuk mengautentikasi Cloud SQL Auth Proxy.

Untuk mengautentikasi Cloud SQL Auth Proxy menggunakan kredensial akun pengguna Anda, jalankan perintah berikut:

gcloud auth application-default login

Mulai Cloud SQL Auth Proxy di terminalnya sendiri sehingga Anda dapat memantau outputnya. Ganti INSTANCE_CONNECTION_NAME dengan nama koneksi instance yang Anda salin di langkah sebelumnya.

Untuk lingkungan Linux atau macOS, gunakan perintah ini untuk meluncurkan Cloud SQL Auth Proxy:

./cloud-sql-proxy INSTANCE_CONNECTION_NAME

Pada PowerShell di Windows, gunakan perintah ini untuk meluncurkan Cloud SQL Auth Proxy:

.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME

Akan muncul pesan yang mirip dengan berikut ini:

Listening on 127.0.0.1:1433 for INSTANCE_CONNECTION_NAME
Ready for new connections

Jalankan perintah berikut dan ganti USER_NAME dengan nama pengguna SQL Server Anda.

sqlcmd -S 127.0.0.1 -U USER_NAME

Kembali ke jendela terminal tempat Anda memulai Cloud SQL Auth Proxy. Anda akan melihat pesan yang mirip dengan berikut ini:

New connection for myInstance

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

1. Di konsol Google Cloud , buka halaman Instance Cloud SQL.

   Buka Instance Cloud SQL

2. Pilih instance myinstance untuk membuka halaman Instance details.
3. Pada panel ikon di bagian atas halaman, klik Hapus.
4. Di jendela Hapus instance, ketik nama instance, lalu klik Hapus.

Langkah-langkah pembersihan opsional

Jika tidak menggunakan API yang diaktifkan sebagai bagian dari panduan memulai ini, Anda dapat menonaktifkannya.

• API yang diaktifkan dalam panduan memulai ini:
  • Cloud SQL Admin API

1. Di konsol Google Cloud , buka halaman APIs.

   Buka API

2. Pilih Cloud SQL Admin API, lalu klik tombol Disable API.

Langkah berikutnya

• Lihat cara memecahkan masalah informasi untuk Cloud SQL Auth Proxy.

• Pelajari Cloud SQL Auth Proxy lebih lanjut.