תהליכים מאוחסנים ב-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

תיאור

תהליך מאוחסן של עטיפה שמגדיר מסד נתונים של הפצה. העטיפה קוראת לפונקציות הבאות: 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

תיאור

יוצר סוכן של קובץ snapshot עבור מסד הנתונים שמפורסם, ופועל כפרוצדורה מאוחסנת של 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

תיאור

יוצרת משימת סוכן מתוזמנת חדשה לסנכרון מינוי ה-Push, ופועלת כפרוצדורה מאוחסנת של עטיפה עבור 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

תיאור

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

פרוצדורה מאוחסנת להגדרת רמות תאימות של מסד נתונים

למידע על רמות התאימות של מסד הנתונים, אפשר לעיין במאמר ALTER DATABASE (Transact-SQL) Compatibility Level.

msdb.dbo.gcloudsql_set_compat_level_for_master_db

תחביר

EXEC msdb.dbo.gcloudsql_set_compat_level_for_master_db @compatibility_level

תיאור

מגדירה את רמת התאימות למסד הנתונים של master. ב-Cloud SQL ל-SQL Server, למשתמשים אין את ההרשאות הנדרשות כדי לשנות את מסד הנתונים master ישירות. הפרוצדורה המאוחסנת הזו מאפשרת לשנות את רמת התאימות שלה, והיא פועלת כעטיפה לפקודה ALTER DATABASE [master] SET COMPATIBILITY_LEVEL.

  • ‫compatibility_level: ערך מסוג מספר שלם שמציין את רמת התאימות להחלה (לדוגמה, 130,‏ 140 או 150). הערך חייב להיות 130 או יותר.

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