שימוש בספריית הלקוח של Python כדי להתחבר ל-Spanner Omni

ספריית הלקוח של Python ל-Spanner פועלת עם Spanner Omni באותו אופן שבו היא פועלת עם Spanner. במאמר הזה נסביר איך להגדיר את ספריית הלקוח של Python כדי ליצור חיבורים מאובטחים ל-Spanner Omni. כדי ליצור את החיבורים האלה, צריך להגדיר את אפשרויות הלקוח כשיוצרים לקוח.

ספריית הלקוח של Python תומכת בטקסט רגיל, ב-TLS, ב-TLS עם פרטי כניסה ובחיבורי mTLS.

מידע נוסף זמין במאמר תחילת העבודה עם Spanner ב-Python במאמרי העזרה של Spanner.

לפני שמתחילים

כדי להשתמש בספריית הלקוח של Python עם Spanner Omni, צריך להשתמש בספריית הלקוח של Python בגרסה 3.72.0 ואילך.

כדי להתקין את חבילת Python של Spanner Omni, מריצים את הפקודה הבאה:

pip install google-cloud-spanner>=3.72.0

הגדרת האובייקט Client

כשמגדירים את האובייקט Client, מציינים את נקודת הקצה של Spanner Omni ב-client_options ומציינים את instance_type=InstanceType.OMNI.

בדוגמאות הבאות אפשר לראות איך להגדיר את האובייקט Client לכל אחת מהגדרות האבטחה הנתמכות:

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,
)

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",
)

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",
)

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",
)

קבלת מסד נתונים

אחרי שמגדירים את אובייקט Client, אפשר לקבל מסד נתונים. מכיוון ש-Spanner Omni לא משתמש Google Cloud במזהי פרויקט או מופע, צריך לציין default כמזהה המופע כשיוצרים Instance:

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

מחליפים את מה שכתוב בשדות הבאים:

• ‫DATABASE_ID: המזהה של מסד הנתונים של Spanner Omni.