Menggunakan library klien Python untuk terhubung ke Spanner Omni

Library klien Python untuk Spanner berfungsi dengan Spanner Omni dengan cara yang sama seperti saat berfungsi dengan Spanner. Dokumen ini menunjukkan cara membuat koneksi yang aman ke Spanner Omni dengan mengonfigurasi library klien Python. Anda membuat koneksi ini dengan menyetel opsi klien saat membuat klien.

Library klien Python mendukung koneksi teks biasa, TLS, TLS dengan kredensial, dan mTLS.

Untuk mengetahui informasi selengkapnya, lihat Mulai menggunakan Spanner di Python dalam dokumentasi Spanner.

Sebelum memulai

Untuk menggunakan library klien Python dengan Spanner Omni, gunakan library klien Python versi 3.72.0 atau yang lebih baru.

Untuk menginstal paket Python Spanner Omni, jalankan perintah berikut:

pip install google-cloud-spanner>=3.72.0

Mengonfigurasi objek Client

Saat mengonfigurasi objek Client, tentukan endpoint Spanner Omni di client_options dan tentukan instance_type=InstanceType.OMNI.

Contoh berikut menunjukkan cara mengonfigurasi objek Client untuk setiap konfigurasi keamanan yang didukung:

Teks biasa

Untuk membuat koneksi teks biasa, tentukan instance_type=InstanceType.OMNI dan use_plain_text=True:

from google.cloud import spanner
from google.cloud.spanner_v1 import InstanceType

spanner_client = spanner.Client(
    client_options={"api_endpoint": "ENDPOINT"},
    instance_type=InstanceType.OMNI,
    use_plain_text=True,
)

Ganti kode berikut:

  • ENDPOINT: endpoint instance Spanner Omni Anda.

TLS

Untuk membuat koneksi TLS, tentukan jalur ke sertifikat CA Anda menggunakan ca_certificate:

from google.cloud import spanner
from google.cloud.spanner_v1 import InstanceType

spanner_client = spanner.Client(
    client_options={"api_endpoint": "ENDPOINT"},
    instance_type=InstanceType.OMNI,
    ca_certificate="PATH_TO_CA_CERT",
)

Ganti kode berikut:

  • ENDPOINT: endpoint instance Spanner Omni Anda.

  • PATH_TO_CA_CERT: jalur ke file sertifikat CA Anda.

TLS dengan kredensial

Untuk membuat koneksi TLS dengan autentikasi nama pengguna dan sandi, tentukan parameter username dan password bersama dengan sertifikat CA:

from google.cloud import spanner
from google.cloud.spanner_v1 import InstanceType

spanner_client = spanner.Client(
    client_options={"api_endpoint": "ENDPOINT"},
    instance_type=InstanceType.OMNI,
    ca_certificate="PATH_TO_CA_CERT",
    username="USERNAME",
    password="PASSWORD",
)

Ganti kode berikut:

  • ENDPOINT: endpoint instance Spanner Omni Anda.

  • PATH_TO_CA_CERT: jalur ke file sertifikat CA Anda.

  • USERNAME: nama pengguna untuk pengguna Spanner Omni Anda.

  • PASSWORD: sandi untuk pengguna Spanner Omni Anda.

mTLS

Untuk membuat koneksi mutual TLS (mTLS), tentukan sertifikat CA, sertifikat klien, dan kunci pribadi klien:

from google.cloud import spanner
from google.cloud.spanner_v1 import InstanceType

spanner_client = spanner.Client(
    client_options={"api_endpoint": "ENDPOINT"},
    instance_type=InstanceType.OMNI,
    ca_certificate="PATH_TO_CA_CERT",
    client_certificate="PATH_TO_CLIENT_CERT",
    client_key="PATH_TO_CLIENT_KEY",
)

Ganti kode berikut:

  • ENDPOINT: endpoint instance Spanner Omni Anda.

  • PATH_TO_CA_CERT: jalur ke file sertifikat CA Anda.

  • PATH_TO_CLIENT_CERT: jalur ke file sertifikat klien Anda.

  • PATH_TO_CLIENT_KEY: jalur ke file kunci pribadi klien Anda.

Mendapatkan database

Setelah mengonfigurasi objek Client, Anda bisa mendapatkan database. Karena Spanner Omni tidak menggunakan project atau ID instance Google Cloud , tentukan default untuk ID instance saat Anda membuat Instance:

instance = spanner_client.instance("default")
database = instance.database("DATABASE_ID")

Ganti kode berikut:

  • DATABASE_ID: ID database Spanner Omni Anda.