פקודות ב-CLI של Spanner

בדף הזה מופיע סיכום של הפקודות הנתמכות ב-CLI של Spanner.

תחביר הפקודה תיאור
SHOW DATABASES; הצגת רשימה של מסדי נתונים.
USE database_name [ROLE role_name]; החלפת מסד נתונים. התפקיד שאתם מגדירים משמש לבקרת גישה פרטנית.
CREATE DATABASE database_name; יצירת מסד נתונים.
DROP DATABASE database_name; מחיקת מסד נתונים.
SHOW TABLES [schema]; הצגת רשימת הטבלאות. אם לא מספקים סכימה, Spanner משתמש בסכימת ברירת המחדל.
SHOW CREATE TABLE table_name; הצגת סכימת הטבלה.
SHOW COLUMNS FROM table_name; הצגת עמודות.
SHOW INDEX FROM table_name; הצגת האינדקסים.
CREATE TABLE ...; ליצור טבלה.
ALTER TABLE ...; שינוי סכימת הטבלה.
DROP TABLE ...; מחיקת הטבלה.
TRUNCATE TABLE table_name; חיתוך הטבלה. מחיקת שורות בלבד. הפקודה הזו לא אטומיות כי היא מבוצעת כפקודת DML מחולקת.
CREATE INDEX ...; יצירת אינדקס.
DROP INDEX ...; מחיקת האינדקס.
CREATE ROLE ...; יצירת תפקיד. מידע נוסף זמין במאמר סקירה כללית על IAM ב-Spanner.
DROP ROLE ...; מחיקת התפקיד.
GRANT ...; נותנים הרשאה לתפקיד.
REVOKE ...; ביטול הרשאה מתפקיד.
SELECT ...; מריצים שאילתה.
{ INSERT|UPDATE|DELETE } ...; מריצים פקודת DML.
PARTITIONED { UPDATE|DELETE } ...; מריצים פקודת DML מחולקת למחיצות. הפקודה הזו לא אטומית.
EXPLAIN SELECT ...; הצגת תוכנית ביצוע של שאילתה. מידע נוסף זמין במאמר בנושא תוכניות להרצת שאילתות.
EXPLAIN {INSERT|UPDATE|DELETE} ...; הצגת תוכנית הביצוע של DML.
EXPLAIN ANALYZE SELECT ...; הצגת תוכנית להפעלת שאילתות עם נתונים סטטיסטיים של הכלי לאופטימיזציה. מידע נוסף זמין במאמר בנושא חבילות נתונים סטטיסטיים של כלי האופטימיזציה.
EXPLAIN ANALYZE {INSERT|UPDATE|DELETE} ...; הצגת תוכנית הביצוע של DML עם נתונים סטטיסטיים של האופטימיזציה. מידע נוסף זמין במאמר בנושא חבילות נתונים סטטיסטיים של כלי האופטימיזציה.
DESCRIBE SELECT ...; הצגת הצורה של תוצאת השאילתה.
DESCRIBE {INSERT|UPDATE|DELETE} ... THEN RETURN ...; הצגת צורת התוצאה של DML.
ANALYZE; מתחילים ליצור חבילת נתונים סטטיסטיים חדשה של אופטימיזציית שאילתות.
START BATCH DDL; מתחילים קבוצת DDL.
RUN BATCH; מריצים פקודות באצווה.
ABORT BATCH; ביטול פקודות להעלאה בכמות גדולה.
BEGIN [RW] [ISOLATION LEVEL {SERIALIZABLE|REPEATABLE READ}] [PRIORITY {HIGH|MEDIUM|LOW}] [TAG tag_name]; מתחילים טרנזקציה של קריאה וכתיבה. מידע נוסף זמין במאמר פקודות של עסקאות.
COMMIT; שמירת עסקה עם הרשאות קריאה וכתיבה.
ROLLBACK; ביטול (undo) של עסקת קריאה-כתיבה.
BEGIN RO [{seconds|RFC 3339-formatted_time}] [PRIORITY {HIGH|MEDIUM|LOW}] [TAG tag_name]; מתחילים טרנזקציה עם הרשאת קריאה בלבד. ‫seconds ו-RFC 3339-formatted_time משמשים לקריאות לא עדכניות. מידע נוסף זמין במאמר פקודות של עסקאות.
CLOSE; סיום עסקה עם הרשאת קריאה בלבד.
EXIT; יוצאים מ-Spanner CLI.

פקודות BATCH

ממשק ה-CLI של Spanner מאפשר לבצע פעולות DDL במצב אצווה, שבו מקבצים כמה הצהרות DDL לפעולה אחת ומאיצים את השינויים בסכימה. ממשק ה-CLI של Spanner תומך בפקודות BATCH הבאות:

START BATCH DDL;

הפקודה הזו מפעילה קבוצת DDL. כל הצהרות ה-DDL הבאות (לדוגמה, CREATE TABLE, ‏ ALTER TABLE, ‏ DROP INDEX) שמופעלות בסשן הזה נשארות במצב 'בהמתנה' ולא מוחלות על מסד הנתונים באופן מיידי.

RUN BATCH;

אחרי שמריצים את הפקודה START BATCH DDL ואת הצהרות ה-DDL הבאות, משתמשים בפקודה RUN BATCH כדי לשלוח את כל פעולות ה-DDL שממתינות לביצוע כבקשה אחת ל-Spanner. הפקודה הזו מצמצמת את התקורה שמשויכת להצהרות DDL נפרדות, וכך מאפשרת לבצע שינויים בסכימה מהר יותר.

ABORT BATCH;

אם תחליטו לא להחיל את שינויי ה-DDL שממתינים לאישור, תשתמשו בפקודה ABORT BATCH. הפקודה הזו מבטלת את כל הצהרות ה-DDL שנאספו מאז שהוצאה הפקודה START BATCH DDL, ובפועל מבצעת Rollback של האצווה ומשאירה את סכימת מסד הנתונים ללא שינוי.

פקודות של עסקאות

ממשק ה-CLI של Spanner תומך בפקודות ה-SQL הבאות של טרנזקציות:

BEGIN [TRANSACTION] [RO] [seconds|RFC 3339-formatted_time ] [ISOLATION LEVEL {SERIALIZABLE|REPEATABLE READ}] [PRIORITY {HIGH|MEDIUM|LOW}] [TAG tag_name];

מתחילים עסקה. אפשר להגדיר את האפשרויות האלה:

  • סוג העסקה: התחלת עסקה לקריאה וכתיבה (לא נדרש פרמטר) או לקריאה בלבד (RO).
  • זמן קריאה בעבר: מגדירים את הזמן בשניות או בפורמט RFC 3339 כדי לקרוא נתונים מחותמת זמן ספציפית.
  • רמת בידוד: הגדרת רמת הבידוד של טרנזקציות קריאה-כתיבה. כברירת מחדל, נעשה שימוש בבידוד שניתן לסדרות. מידע נוסף זמין במאמר סקירה כללית של רמות הבידוד.
  • עדיפות: הגדרת העדיפות של הבקשה לעסקה. העדיפות הבינונית מוגדרת כברירת מחדל.

  • תג: מגדירים תגי עסקאות באמצעות הפקודה BEGIN.

    • בעסקה עם הרשאת קריאה וכתיבה, מוסיפים תג עם BEGIN TAG tag. ממשק ה-CLI של Spanner מוסיף את התג כתג עסקה. התג משמש גם כתג בקשה בתוך העסקה.
    • בעסקה עם הרשאת קריאה בלבד, מוסיפים תג באמצעות BEGIN RO TAG tag. מכיוון שעסקאות לקריאה בלבד לא תומכות בתגי עסקאות, מערכת Spanner מוסיפה את התג כתג בקשה.

COMMIT;

לסיים את העסקה ולהפוך את כל השינויים לקבועים בעסקה עם הרשאת קריאה וכתיבה.

CLOSE;

סגירת טרנזקציה לקריאה בלבד.

ROLLBACK;

ביטול (undo) של עסקת קריאה-כתיבה.

המאמרים הבאים