Menghubungkan ke Cloud SQL untuk SQL Server dari komputer lokal
Pelajari cara men-deploy aplikasi contoh di komputer lokal Anda berbasis Linux, macOS, atau Windows yang terhubung ke instance SQL Server menggunakan konsol Google Cloud dan aplikasi klien.
Dengan asumsi bahwa Anda menyelesaikan semua langkah secara tepat waktu, resource yang dibuat dalam panduan memulai ini biasanya memiliki harga kurang dari satu dolar (USD).
Sebelum memulai
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Aktifkan Cloud API yang diperlukan untuk menjalankan aplikasi sampel Cloud SQL di komputer lokal Anda.
Konsol
Klik tombol Enable APIs untuk mengaktifkan API yang diperlukan untuk panduan memulai ini.
Tindakan ini memungkinkan API berikut:
- Cloud SQL Admin API
- IAM API
gcloud
Instal gcloud CLI yang menyediakan akses command line ke resource Google Cloud Anda. Gcloud CLI digunakan untuk menjalankan perintah
gcloud CLI
yang ditampilkan di seluruh panduan memulai ini. Semua perintah diformat untuk dijalankan di terminal Linux/macOS atau di Windows Powershell.Buka terminal dan jalankan perintah
gcloud
berikut:gcloud services enable sqladmin.googleapis.com iam.googleapis.com
Perintah ini mengaktifkan API berikut:
- Cloud SQL Admin API
- IAM API
Menyiapkan Cloud SQL
Membuat instance Cloud SQL
Konsol
Membuat instance dengan alamat IP publik
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Klik Create Instance.
- Klik Choose SQL Server.
- Masukkan
quickstart-instance
untuk Instance ID. - Masukkan sandi untuk pengguna sqlserver. Simpan sandi ini untuk penggunaan berikutnya.
- Klik opsi Single zone untuk Choose region and zonal availability.
- Klik dan luaskan bagian Show Configuration Options.
- Pada menu drop-down Machine Type, pilih Lightweight.
Klik Buat Instance dan tunggu hingga instance melakukan inisialisasi dan mulai.
gcloud
Membuat instance dengan alamat IP publik
Sebelum menjalankan perintah gcloud
sql instances create
sebagai berikut, ganti DB_ROOT_PASSWORD dengan sandi pengguna database Anda.
Atau, ubah nilai untuk parameter berikut:
- --database_version: Jenis dan versi mesin database. Jika tidak ditentukan, API default akan digunakan. Lihat dokumentasi versi database gcloud untuk melihat versi yang tersedia saat ini.
- --cpu: Jumlah core yang akan ditetapkan dalam mesin.
- --memory: Nilai bilangan bulat yang menunjukkan jumlah memori yang harus ditetapkan di mesin. Unit ukuran harus disediakan (misalnya, 3072 MB atau 9 GB). Jika tidak ada unit yang ditentukan, GB akan digunakan.
- --region: Lokasi regional instance
(misalnya asia-east1, us-east1). Jika tidak ditentukan,
us-central
default akan digunakan. Lihat daftar lengkap region.
Jalankan perintah gcloud
sql instances create
untuk membuat instance Cloud SQL.
gcloud sql instances create quickstart-instance --database-version=SQLSERVER_2019_STANDARD --cpu=1 --memory=4GB --region=us-central --root-password=DB_ROOT_PASSWORD
Buat database
Konsol
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Pilih
quickstart-instance
. - Buka tab Databases.
- Klik Create database.
- Dalam dialog New database, masukkan
quickstart_db
sebagai nama database.
- Klik Create.
gcloud
Jalankan perintah gcloud
sql databases create
untuk membuat database.
gcloud sql databases create quickstart_db --instance=quickstart-instance
Menyiapkan akun layanan
Konsol
Membuat akun layanan
- Di konsol Google Cloud, buka halaman Create service account.
- Pilih project Google Cloud.
- Masukkan
quickstart-service-account
sebagai nama akun layanan. - Opsional: Masukkan deskripsi akun layanan.
- Klik Buat dan lanjutkan serta lanjutkan ke langkah berikutnya.
- Pilih peran Klien Cloud SQL yang akan diberikan ke akun layanan pada project.
- Klik Lanjutkan.
- Klik Selesai untuk menyelesaikan pembuatan akun layanan.
Membuat dan mendownload file kunci akun layanan
- Di Konsol Google Cloud, buka halaman Service accounts.
- Pilih project.
- Klik alamat email akun layanan
quickstart-service-account
yang ingin Anda buatkan kunci. - Klik tab Kunci.
- Klik menu drop-down Kunci, lalu pilih Buat kunci baru.
- Pilih JSON sebagai jenis kunci dan klik Create.
Mengklik Buat akan mendownload file kunci akun layanan. Setelah mendownload file kunci, Anda tidak dapat mendownloadnya lagi.
Pastikan Anda menyimpan file kunci dengan aman, karena file tersebut dapat digunakan untuk melakukan autentikasi sebagai akun layanan Anda. Anda dapat memindahkan dan mengganti nama file ini sesuai keinginan.
gcloud
Membuat akun layanan
- Untuk membuat akun layanan, jalankan
gcloud iam service-accounts create
perintah: DESCRIPTION
: Deskripsi opsional untuk akun layanan- Untuk memberikan peran Klien Cloud SQL pada project Anda pada akun layanan, jalankan
gcloud projects add-iam-policy-binding
perintah. Ganti PROJECT_ID dengan ID project Google Cloud Anda.gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client"
gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"
Ganti nilai berikut:
Membuat dan mendownload file kunci akun layanan
Untuk menggunakan akun layanan yang baru saja dibuat dari komputer lokal, Anda memerlukan file kunci akun layanan untuk
mengautentikasi aplikasi sampel sebagai akun layanan. Untuk membuat dan mendownload file kunci akun layanan, jalankan
gcloud iam service-accounts keys create
perintah:
gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com
Ganti nilai berikut:
-
KEY_FILE
: Jalur ke file output baru untuk kunci pribadi — misalnya,~/sa-private-key.json
. -
PROJECT_ID
: ID project Google Cloud Anda.
File kunci akun layanan kini didownload ke komputer lokal Anda. Setelah mendownload file kunci, Anda tidak dapat mendownloadnya lagi.
Pastikan Anda menyimpan file kunci dengan aman karena siapa pun dapat menggunakannya untuk mengautentikasi sebagai akun layanan Anda. Anda dapat memindahkan dan mengganti nama file ini sesuai keinginan.
Menyiapkan lingkungan pengembangan untuk bahasa pemrograman
Siapkan lingkungan pengembangan komputer lokal untuk bahasa pemrograman pilihan Anda.
Go
Selesaikan langkah-langkah berikut untuk menyiapkan lingkungan pengembangan Anda untuk menjalankan aplikasi sampel Go.
- Buka panduan penyiapan untuk lingkungan pengembangan Go.
- Selesaikan petunjuk di bagian Install Go.
Java
Selesaikan langkah-langkah berikut untuk menyiapkan lingkungan pengembangan Anda untuk menjalankan aplikasi sampel Java.
- Buka panduan penyiapan untuk lingkungan pengembangan Java.
- Selesaikan petunjuk di bagian Instal JDK (Java Development Kit).
- Selesaikan petunjuk di instal alat otomatis build untuk menyiapkan Apache Maven.
Node.js
Selesaikan langkah-langkah berikut untuk menyiapkan lingkungan pengembangan Anda guna menjalankan aplikasi sampel Node.js.
- Buka panduan penyiapan untuk lingkungan pengembangan Node.js.
- Selesaikan petunjuk di bagian Instal Node.js and npm.
Python
Selesaikan langkah-langkah berikut untuk menyiapkan lingkungan pengembangan Anda untuk menjalankan aplikasi sampel Python.
- Buka panduan penyiapan untuk lingkungan pengembangan Python.
- Selesaikan petunjuk di bagian Instal Python.
Instal Git
Instal Git, sistem kontrol versi open source.
Meng-clone aplikasi sampel
Clone aplikasi sampel ke komputer lokal Anda menggunakan git clone
perintah.
Go
Jalankan perintah berikut untuk meng-clone aplikasi sampel Go ke komputer lokal Anda dan ubah direktori ke direktori yang berisi aplikasi sampel.
-
Membuat clone aplikasi sampel.
git clone https://github.com/GoogleCloudPlatform/golang-samples
-
Ubah direktori ke direktori yang berisi aplikasi sampel.
cd golang-samples/cloudsql/sqlserver/database-sql
Java
Jalankan perintah berikut untuk meng-clone aplikasi sampel Java ke komputer lokal Anda dan ubah direktori ke direktori yang berisi aplikasi sampel.
-
Membuat clone aplikasi sampel.
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
-
Ubah direktori ke direktori yang berisi aplikasi sampel.
cd java-docs-samples/cloud-sql/sqlserver/servlet
Node.js
Jalankan perintah berikut untuk meng-clone aplikasi sampel Node.js ke komputer lokal Anda dan ubah direktori ke direktori yang berisi aplikasi sampel.
-
Membuat clone aplikasi sampel.
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
-
Ubah direktori ke direktori yang berisi aplikasi sampel.
cd nodejs-docs-samples/cloud-sql/sqlserver/mssql
Python
Jalankan perintah berikut untuk meng-clone aplikasi sampel Python ke komputer lokal Anda dan ubah direktori ke direktori yang berisi aplikasi sampel.
-
Membuat clone aplikasi sampel.
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
-
Ubah direktori ke direktori yang berisi aplikasi sampel.
cd python-docs-samples/cloud-sql/sql-server/sqlalchemy
Mengonfigurasi dan menjalankan aplikasi sampel
Mengonfigurasi dan menjalankan aplikasi sampel.
Pembersihan
Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Pilih instance
quickstart-instance
untuk membuka halaman Detail instance. - Pada panel ikon di bagian atas halaman, klik Hapus.
- Di kotak dialog Hapus instance, ketik
quickstart-instance
, lalu klik Hapus untuk menghapus instance.
Langkah-langkah pembersihan opsional
Jika tidak menggunakan peran klien Cloud SQL yang ditetapkan ke akun layanan
quickstart-service-account
, Anda dapat menghapusnya.
-
Di Konsol Google Cloud, buka halaman IAM.
- Klik ikon edit (yang terlihat seperti pensil) untuk akun IAM bernama akun layanan panduan memulai.
- Hapus peran klien Cloud SQL.
- Klik Simpan.
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
- Identity and Access Management API
Di konsol Google Cloud, buka halaman API.
Pilih API yang ingin Anda nonaktifkan, lalu klik tombol Nonaktifkan API.
Langkah berikutnya
Berdasarkan kebutuhan, Anda dapat mempelajari lebih lanjut cara membuat instance Cloud SQL.Anda juga dapat mempelajari cara membuat pengguna SQL Server dan database untuk instance Cloud SQL.
Untuk mengetahui informasi selengkapnya tentang harga, lihat harga Cloud SQL untuk SQL Server.
Pelajari lebih lanjut:
- Mengonfigurasi instance Cloud SQL Anda dengan alamat IP publik.
- Mengonfigurasi instance Cloud SQL Anda dengan alamat IP pribadi.
Selain itu, Anda dapat mempelajari cara menghubungkan ke instance Cloud SQL dari aplikasi Google Cloud lainnya: