מדריך למתחילים לשימוש ב-Spanner Omni CLI

במסמך הזה מוסבר איך להשתמש בממשק שורת הפקודה (CLI) של Spanner Omni כדי ליצור אינטראקציה עם פריסת Spanner Omni ולנהל אותה. ‫Spanner Omni CLI מספק פקודות למשימות ניהול נפוצות, וכולל מעטפת SQL אינטראקטיבית לשליחת שאילתות למסד הנתונים.

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

כדי להשתמש ב-Spanner Omni CLI, אתם צריכים לעמוד בדרישות הבאות:

  1. פריסת Spanner Omni מוגדרת ופועלת.
  2. למחשב שבו מריצים את Spanner Omni CLI יש גישה לרשת של מאזן העומסים של פריסת Spanner Omni או לשרת אחד לפחות בפריסה.

שלב 1: הורדה והתקנה של Spanner Omni CLI

  1. מורידים את Spanner Omni CLI מspanner-omni קטגוריית Cloud Storage.

    כניסה לדלי Spanner Omni

  2. מחלצים את קובץ ה-tar.

    tar -xvf CLI_TAR_FILE

    הפקודה הזו מתקינה את הקובץ הבינארי של Spanner Omni CLI, שנקרא spanner, בספרייה google/spanner/bin.

    כדי להריץ את הפקודה spanner, מוסיפים את הספרייה google/spanner/bin למשתנה הסביבה PATH, או משתמשים בנתיב המלא לקובץ הבינארי בשלבים הבאים.

שלב 2: התחברות לפריסה

כברירת מחדל, Spanner Omni CLI מנסה להתחבר אל localhost:15000. כדי להתחבר לפריסה ספציפית, משתמשים בדגל --deployment-endpoint.

לדוגמה, הפקודה הבאה מציגה את האזורים בפריסה:

spanner deployment zones list \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

שלב 3: מריצים פקודות נפוצות

אלה פקודות ניהול נפוצות שאפשר להריץ באמצעות Spanner Omni CLI.

קבלת עזרה

כדי לראות רשימה של הפקודות הזמינות והדגלים הגלובליים, מריצים את הפקודה:

spanner --help

יצירת מסד נתונים

כדי ליצור מסד נתונים חדש בפריסה, מריצים את הפקודה:

spanner databases create DATABASE_NAME \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

הצגת רשימה של כל מסדי הנתונים

כדי להציג רשימה של כל מסדי הנתונים בפריסה, מריצים את הפקודה:

spanner databases list \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

שלב 4: הפעלת סשן אינטראקטיבי של מעטפת SQL

‫Spanner Omni CLI כולל מעטפת SQL אינטראקטיבית להרצת שאילתות. אם מפעילים את המעטפת למסד נתונים ספציפי עם הדגל --database, אפשר להריץ פקודות SQL בלי לציין את מסד הנתונים או נקודת הקצה לכל שאילתה.

כדי להפעיל את מעטפת ה-SQL, מריצים את הפקודה:

spanner sql --database=DATABASE_NAME \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

אחרי שהמעטפת מתחילה, מופיעה ההנחיה sql>:

spanner-cli>

כדי לצאת מהמעטפת, מקלידים exit.