תהליכים מאוחסנים ב-Cloud SQL

בקטע הזה מתוארים פרוצדורות מאוחסנות למכונות Cloud SQL.

פרוצדורה מאוחסנת מכילה קוד SQL שאפשר לעשות בו שימוש חוזר.

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

  • ‫procedure_name הוא השם של התהליך המאוחסן.
  • ‫database_name הוא שם מסד הנתונים שבו רוצים להריץ את הפרוצדורה.
  • ‫schema_name הוא שם הסכימה שבה רוצים להריץ את הפרוצדורה.
EXEC database_name.schema_name.procedure_name @param1, @param2;
 מידע נוסף זמין בדף העיון בנושא EXECUTE (Transact-SQL).

כדי ליצור פרוצדורה מאוחסנת משלכם, אפשר לעיין במאמר יצירת פרוצדורה מאוחסנת.

פרוצדורות מאוחסנות ב-Cloud SQL ל-SQL Server

תהליך מאוחסן לשימוש בהוספה בכמות גדולה

מידע על הוספה בכמות גדולה זמין במאמר שימוש בהוספה בכמות גדולה לייבוא נתונים.

msdb.dbo.gcloudsql_bulk_insert

תחביר

EXEC msdb.dbo.gcloudsql_bulk_insert @database @schema @object @file ...

תיאור

לפרוצדורה המאוחסנת הזו יש פרמטרים והתנהגות דומים לפקודה BULK INSERT.

הפרוצדורה המאוחסנת מייבאת נתונים למופע Cloud SQL מקובץ שמאוחסן בקטגוריה של Cloud Storage. הוא משתמש ב-Cloud Storage interoperable API ובמפתחות HMAC כדי לאמת את הגישה לקטגוריה של Cloud Storage.

התהליך המאוחסן הזה כולל את הפרמטרים הבאים:

פרמטר סוג תיאור
@database SYSNAME מציינים את שם מסד הנתונים של היעד שאליו רוצים לייבא את הנתונים.
@schema SYSNAME מציין את שם הסכימה שאליה הטבלה שייכת.
@object NVARCHAR מציינים את שם הטבלה שבה רוצים להוסיף את הנתונים.
@file NVARCHAR מציינת את הנתיב לקובץ הייבוא בקטגוריה של Cloud Storage.

הנתיב צריך להיות בפורמט הבא: 

 s3://storage.googleapis.com/BUCKET_NAME/FILE_PATH

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

  • ‫BUCKET_NAME: מציין את שם הקטגוריה של Cloud Storage.
  • ‫FILE_PATH: מציין את הנתיב לקובץ שמאוחסן בקטגוריה של Cloud Storage.
@batchsize INT מציין את מספר השורות באצווה.
@checkconstraints BIT מציין שצריך לבדוק את כל האילוצים בטבלת היעד.
@codepage NVARCHAR מציין את דף הקוד של הנתונים בקובץ. ‫RAW היא ברירת המחדל והאפשרות היחידה.
@datafiletype NVARCHAR מציין את סוג הקובץ להוספה בכמות גדולה.
@datasource NVARCHAR מציינת את השם של מקור הנתונים החיצוני שממנו רוצים לייבא את הנתונים.
@errorfile NVARCHAR מציינים את הנתיב לקובץ שמשמש לאיסוף שורות עם שגיאות עיצוב.

הנתיב צריך להיות בפורמט הבא: 

 s3://storage.googleapis.com/BUCKET_NAME/FILE_PATH

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

  • ‫BUCKET_NAME: מציין את שם הקטגוריה של Cloud Storage.
  • ‫FILE_PATH: מציין את הנתיב לקובץ שמאוחסן בקטגוריה של Cloud Storage.

בנוסף, Cloud SQL יוצר קובץ עם הסיומת .ERROR.txt. הקובץ הזה מכיל הפניות לכל שורה בקובץ השגיאות, ומספק אבחון שגיאות.

@errorfiledatasource NVARCHAR מציינים את השם של מקור הנתונים החיצוני שבו רוצים ליצור את קובץ השגיאות.
@firstrow INT מציין את המזהה המספרי של השורה הראשונה לטעינה.
@firetriggers BIT מציין שכל טריגר של הוספה שהוגדר בטבלת היעד יופעל במהלך פעולות ההוספה בכמות גדולה.
@formatfiledatasource NVARCHAR מציינים את השם של מקור הנתונים החיצוני שממנו צריך לטעון את קובץ הפורמט.
@keepidentity BIT מציין את השימוש בנתוני זהות מקובץ הייבוא עבור עמודת הזהות. הערכים הם 0 (false) ו-1 (true).
@keepnulls BIT מציין אם עמודות ריקות צריכות לשמור על ערך null במהלך פעולת הייבוא בכמות גדולה, במקום להוסיף ערכי ברירת מחדל לעמודות. הערכים הם 0 (false) ו-1 (true).
@kilobytesperbatch INT מציינת את כמות הנתונים לכל אצווה, ביחידות KB.
@lastrow INT מציינת את המזהה המספרי של השורה האחרונה לטעינה.
@maxerrors INT מציינת את מספר השגיאות המותר לפני ש-Cloud SQL מבטל את הפעולה.
@ordercolumnsjson NVARCHAR מציין את סדר המיון והעמודות בפורמט JSON. לדוגמה: 
[{"name": "COLUMN_NAME","order": "ORDER"},{"name": "COLUMN_NAME","order": "ORDER"}]

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

  • ‫COLUMN_NAME: שם העמודה.
  • ‫ORDER: סדר המיון. הערך של הפרמטר הזה יכול להיות asc לסדר עולה או desc לסדר יורד.
@rowsperbatch INT מציין את מספר השורות בכל קבוצה.

מידע נוסף על בחירת גודל אצווה זמין במאמר שיקולים לגבי ביצועים.

@tablock BIT מציינת שנעילת טבלה מתבצעת למשך פעולת ההוספה בכמות גדולה.
@format NVARCHAR מציין את הפורמט של הקובץ. משתמשים בערך CSV של הפרמטר הזה.
@fieldquote NVARCHAR מציינים את התו שישמש כתו מרכאות בקובץ ה-CSV.

אם לא מציינים ערך, Cloud SQL משתמש בערך " כברירת מחדל.
@formatfile NVARCHAR מציין את הנתיב של הקובץ ב-Cloud Storage שמתאר את פורמט הנתונים לייבוא.

הנתיב צריך להיות בפורמט הבא: 

 s3://storage.googleapis.com/BUCKET_NAME/FILE_PATH

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

  • ‫BUCKET_NAME: מציין את שם הקטגוריה של Cloud Storage.
  • ‫FILE_PATH: מציין את הנתיב לקובץ שמאוחסן בקטגוריה של Cloud Storage.
@fieldterminator NVARCHAR מציין את התו שמסיים את השדה בקובצי נתונים מסוג char ו-widechar.
@rowterminator NVARCHAR מציין את סיום השורה עבור קובצי נתונים מסוג char ו-widechar.

תהליכים מאוחסנים לפונקציונליות של ביקורת ב-SQL Server

מידע על שימוש בפונקציונליות של SQL Server Audit זמין במאמר בנושא ביקורת במסד נתונים של SQL Server.

msdb.dbo.gcloudsql_fn_get_audit_file

תחביר

msdb.dbo.gcloudsql_fn_get_audit_file

תיאור

מאחזרת את הנתונים מקובץ ביקורת שנוצר על ידי הפונקציונליות של SQL Server Audit.

הפרוצדורה המאוחסנת הזו מקבלת את אותם פרמטרים כמו הפונקציה sys.fn_get_audit_file. מידע נוסף על msdb.dbo.gcloudsql_fn_get_audit_file מופיע במאמרי העזרה על הפונקציה.

תהליכים מאוחסנים לסימון נתונים שהשתנו (CDC)

מידע נוסף על CDC זמין במאמר הפעלת CDC.

msdb.dbo.gcloudsql_cdc_enable_db

תחביר

exec msdb.dbo.gcloudsql_cdc_enable_db databaseName

תיאור

הפעלת סימון נתונים שהשתנו (CDC) במסד נתונים.

  • ‫databaseName – שם מסד הנתונים שבו רוצים להריץ את הפרוצדורה המאוחסנת הזו.

msdb.dbo.gcloudsql_cdc_disable_db

תחביר

exec msdb.dbo.gcloudsql_cdc_disable_db databaseName

תיאור

הפונקציה משביתה את ה-CDC במסד נתונים.

  • ‫databaseName – שם מסד הנתונים שבו רוצים להריץ את הפרוצדורה המאוחסנת הזו.

פרוצדורות מאוחסנות לשכפול חיצוני עם Cloud SQL כמפרסם

מידע נוסף על פרסום למנוי חיצוני או למופע אחר של Cloud SQL זמין במאמר הגדרת רפליקות חיצוניות.

msdb.dbo.gcloudsql_transrepl_setup_distribution

תחביר

    exec msdb.dbo.gcloudsql_transrepl_setup_distribution @login,@password

תיאור

תהליך מאוחסן של wrapper שמגדיר מסד נתונים של הפצה. העטיפה קוראת לפונקציות הבאות: sp_adddistributor, sp_adddistributiondb, ו- sp_adddistpublisher.

  • ‫login – פרטי כניסה קיימים שמשמשים לחיבור וליצירת מסד הנתונים של ההפצה.
  • ‫password – הסיסמה שמשמשת לחיבור למפיץ.

msdb.dbo.gcloudsql_transrepl_replicationdboption

תחביר

    exec msdb.dbo.gcloudsql_transrepl_replicationdboption @db,@value

תיאור

הפעלה או השבתה של אפשרות הפרסום של מסד נתונים עבור המוציא לאור שמשתמש ב-sp_replicationdboption.

  • ‫db – מסד הנתונים שעבורו מוגדרת אפשרות השכפול.
  • ‫value – מאפשר לציין True כדי להפעיל את אפשרות הפרסום, או False כדי להשבית אותה.

msdb.dbo.gcloudsql_transrepl_addlogreader_agent

תחביר

    exec msdb.dbo.gcloudsql_transrepl_addlogreader_agent @db,@login,@password

תיאור

מגדירה את סוכן קריאת היומן למסד נתונים שמשתמש ב-sp_addlogreader_agent.

  • ‫db – מסד הנתונים לפרסום.
  • login – פרטי ההתחברות שמשמשים להתחברות לאתר של בעל התוכן הדיגיטלי.
  • ‫password – הסיסמה שמשמשת לחיבור.

msdb.dbo.gcloudsql_transrepl_addpublication

תחביר

    exec msdb.dbo.gcloudsql_transrepl_addpublication @db,@publication

תיאור

יוצרת את הפרסום של העסקאות ופועלת כפרוצדורה מאוחסנת של wrapper עבור sp_addpublication.

  • ‫db – מסד הנתונים שמתפרסם.
  • ‫publication – שם אתר החדשות החדש שנוצר.

msdb.dbo.gcloudsql_transrepl_droppublication

תחביר

    exec msdb.dbo.gcloudsql_transrepl_droppublication @db,@publication

תיאור

היא מבטלת את הפרסום של העסקאות ופועלת כפרוצדורה מאוגדת מאוחסנת עבור sp_droppublication.

  • ‫db – מסד הנתונים שממנו מוסרת הפרסום.
  • ‫publication – שם הפרסום הוסר.

msdb.dbo.gcloudsql_transrepl_addpublication_snapshot

תחביר

    exec msdb.dbo.gcloudsql_transrepl_addpublication_snapshot  @db,@publication,@login,@password

תיאור

יוצר סוכן של תמונת מצב עבור מסד הנתונים שמפורסם, ופועל כפרוצדורה מאוחסנת של wrapper עבור sp_addpublication_snapshot.

  • ‫db – מסד הנתונים שממנו מוסרת הפרסום.
  • ‫publication – שם הפרסום הוסר.
  • login – פרטי ההתחברות שמשמשים להתחברות לאתר של בעל התוכן הדיגיטלי.
  • ‫password – הסיסמה שמשמשת לחיבור.

msdb.dbo.gcloudsql_transrepl_addpushsubscription_agent

תחביר

    exec msdb.dbo.gcloudsql_transrepl_addpushsubscription_agent
      @db,@publication,@subscriber_db,@subscriber_login,
        @subscriber_password,@subscriber

תיאור

יוצרת משימת סוכן מתוזמנת חדשה כדי לסנכרן את מינוי הדחיפה, ופועלת כפרוצדורה מאגדת מאוחסנת עבור sp_addpushsubscription_agent.

  • ‫db – מסד הנתונים שפורסם.
  • ‫publication – שם הפרסום שאליו רוצים להוסיף סוכן של מינוי לשליחת הודעות פוש.
  • ‫subscriber_db – מסד הנתונים במנוי.
  • ‫subscriber_login – פרטי ההתחברות שמשמשים לחיבור למנוי.
  • ‫subscriber_password – הסיסמה שמשמשת לחיבור למנוי.
  • ‫subscriber – שם ה-IP של מופע המנוי. אפשר לציין את הערך הזה כך: <Hostname>,<PortNumber>

msdb.dbo.gcloudsql_transrepl_addmonitoraccess

תחביר

    exec msdb.dbo.gcloudsql_transrepl_addmonitoraccess @login

תיאור

הגישה ניתנת ל-Replication Monitor ולמשפט SELECT בטבלאות שקשורות לשכפול במסד הנתונים של ההפצה.

  • ‫login – פרטי הכניסה שמשמשים לגישה לכלי למעקב אחר שכפול.

msdb.dbo.gcloudsql_transrepl_changedistributor_property

תחביר

    exec msdb.dbo.gcloudsql_transrepl_changedistributor_property @property,@value

תיאור

הפרוצדורה המאוחסנת הזו משנה את heartbeat_interval ועוטפת את sp_changedistributor_property. מידע נוסף זמין במאמרי העזרה בנושא sp_changedistributor_property. במסמכי התיעוד האלה יש גם מידע נוסף על הערך heartbeat_interval.

  • ‫property – הנכס של מסד נתונים להפצה.
  • ‫value – הערך שצריך לספק למאפיין שצוין.

msdb.dbo.gcloudsql_transrepl_dropsubscriber

תחביר

    exec msdb.dbo.gcloudsql_transrepl_dropsubscriber @subscriber

תיאור

מסירה את המנוי, ופועלת כפרוצדורה מאוחסנת של עטיפה עבור sp_dropsubscriber.

  • ‫subscriber – שם ה-IP של המנוי שרוצים להסיר. אפשר לציין את הערך הזה כך: <Hostname>,<PortNumber>

msdb.dbo.gcloudsql_transrepl_remove_distribution

תחביר

     exec msdb.dbo.gcloudsql_transrepl_remove_distribution

תיאור

הפעולה מסירה את הגדרת ההפצה, ופועלת כפרוצדורה מאוחסנת (wrapper) עבור הפעולות הבאות: sp_dropdistpublisher, sp_dropdistributiondb, ו- sp_dropdistributor.

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