ייצוא וקריאה של טביעת הרגל הפחמנית באמצעות API

לדיווח על טביעת רגל פחמנית אין API ציבורי ייעודי. עם זאת, אפשר לייצא את טביעת הרגל הפחמנית באמצעות BigQuery Data Transfer Service API, ואז להריץ שאילתות על הנתונים באמצעות BigQuery API.

שימוש ב-BigQuery Data Transfer Service API

כדי להפעיל את שירות העברת נתונים ל-BigQuery API, אפשר להשתמש בספריות הלקוח שסופקו או להפעיל ישירות את API בארכיטקטורת REST.

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

יצירת ייצוא באמצעות API בארכיטקטורת REST

קוראים לנקודת הקצה transferConfigs.create של שירות העברת נתונים ל-BigQuery API כדי ליצור העברה, באמצעות מטען ייעודי (payload) הבא:

{
  "dataSourceId": "61cede5a-0000-2440-ad42-883d24f8f7b8",
  "displayName": "NAME",
  "params": {
    "billing_accounts": "BILLING_ACCOUNT_IDS"
  },
  "destinationDatasetId": "DATASET"
}

מחליפים את:

  • ‫NAME בשם של הגדרות ההעברה. לדוגמה: "Company Carbon Report"
  • ‫BILLING_ACCOUNT_IDS עם מזהה החשבון לחיוב. הערך הזה יכול להיות רשימה מופרדת בפסיקים של מזהי חשבונות לחיוב. לדוגמה: XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX
  • ‫DATASET עם מזהה מערך הנתונים של היעד ב-BigQuery בפרויקט הנוכחי. לדוגמה: company_carbon_report

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

הפעלת מילוי חוזר של נתונים היסטוריים באמצעות API בארכיטקטורת REST

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

כדי ליצור מילוי חוסרים, שולחים בקשת POST לנקודת הקצה transferConfigs.startManualRuns, באמצעות המזהה של ההעברה שנוצרה בשלב הקודם (לדוגמה, projects/0000000000000/locations/us/transferConfigs/00000000-0000-0000-0000-000000000000) ומטען הייעודי (payload) הבא:

{
  "requestedTimeRange": {
    "startTime": "<var>START_TIME</var>",
    "endTime": "<var>END_TIME</var>"
  }
}

כאשר:

  • ‫START_TIME הוא חותמת זמן שמציינת את שעת ההתחלה של הטווח למילוי החסר. לדוגמה: 2021-02-15T00:00:00Z. שימו לב: התאריך המוקדם ביותר שאפשר לציין כאן הוא 15 בפברואר 2021, כי הוא כולל את הנתונים של ינואר 2021.
  • ‫END_TIME היא חותמת זמן שמציינת את שעת הסיום של הטווח למילוי החוסרים. לדוגמה: 2022-09-15T00:00:00Z. אפשר להשתמש בתאריך הנוכחי.

ביצוע שאילתה לייצוא קיים באמצעות API

לפני שמריצים שאילתה ב-API, כותבים שאילתת SQL שמחזירה את הנתונים הרצויים ממערך הנתונים שיוצא. אפשר לבדוק את שאילתת ה-SQL במסוף BigQuery.

אחרי הגדרת ייצוא ל-BigQuery, אפשר להשתמש ב-BigQuery API או בספריות של BigQuery כדי להריץ את השאילתה.

מה השלב הבא?