עדכון התוויות

בדף הזה מוסבר איך לעדכן תוויות במשאבים של BigQuery.

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

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

עדכון תוויות של מערך נתונים

אפשר לעדכן תווית של מערך נתונים באמצעות:

  • באמצעות מסוף Google Cloud
  • באמצעות הצהרות DDL ב-SQL
  • שימוש בפקודה bq update של כלי שורת הפקודה של BigQuery
  • שליחת קריאה ל-method‏ datasets.patch של ה-API
  • שימוש בספריות הלקוח

ההרשאות הנדרשות

כדי לעדכן תווית של מערך נתונים, צריך את הרשאת ה-IAM‏ bigquery.datasets.update.

כל אחד מהתפקידים הבאים שמוגדרים מראש ב-IAM כולל את ההרשאות שנדרשות כדי לעדכן תווית של מערך נתונים:

  • roles/bigquery.dataOwner
  • roles/bigquery.admin

בנוסף, אם יש לכם את ההרשאה bigquery.datasets.create, אתם יכולים לעדכן את התוויות של מערכי הנתונים שאתם יוצרים.

למידע נוסף על תפקידים והרשאות של IAM ב-BigQuery, קראו את המאמר תפקידים והרשאות מוגדרים מראש.

עדכון תווית של קבוצת נתונים

כדי לעדכן תוויות במערך נתונים, בוחרים באחת מהאפשרויות הבאות:

המסוף

  1. במסוף Google Cloud , בוחרים את מערך הנתונים.

  2. לוחצים על הכרטיסייה Details ואז על Edit details.

  3. בקטע Labels, משנים את השדות הקיימים Key או Value כדי לעדכן תווית. כדי להוסיף עוד תוויות, לוחצים על Add labels. אפשר להשתמש בכל מפתח רק פעם אחת בכל מערך נתונים, אבל אפשר להשתמש באותו מפתח במערכי נתונים שונים באותו פרויקט.

  4. לוחצים על Save.

SQL

משתמשים בהצהרת ה-DDL‏ ALTER SCHEMA SET OPTIONS כדי להגדיר את התוויות במערך נתונים קיים. הגדרת תוויות מחליפה את כל התוויות הקיימות במערך הנתונים. בדוגמה הבאה מגדירים תווית אחת במערך הנתונים mydataset:

  1. נכנסים לדף BigQuery במסוף Google Cloud .

    כניסה ל-BigQuery

  2. בעורך השאילתות, מזינים את ההצהרה הבאה:

    ALTER SCHEMA mydataset
SET OPTIONS (labels = [('sensitivity', 'high')]);

  3. ‫לוחצים על Run.

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

BQ

כדי להוסיף עוד תוויות או לעדכן תווית של מערך נתונים, מפעילים את הפקודה bq update עם הדגל set_label. חוזרים על הדגל כדי להוסיף או לעדכן כמה תוויות.

אם מערך הנתונים נמצא בפרויקט אחר, ולא בפרויקט ברירת המחדל, צריך להוסיף את מזהה הפרויקט למערך הנתונים בפורמט הבא: [PROJECT_ID]:[DATASET].

bq update \
--set_label key:value \
project_id:dataset

כאשר:

  • ‫key:value תואם לצמד מפתח:ערך של תווית שרוצים להוסיף או לעדכן. אם מציינים מפתח זהה לתווית קיימת, הערך של התווית הקיימת מתעדכן. המפתח חייב להיות ייחודי.
  • ‫project_id הוא מזהה הפרויקט.
  • ‫dataset הוא מערך הנתונים שמעדכנים.

דוגמה:

כדי לעדכן את התווית department ב-mydataset, מזינים את הפקודה bq update ומציינים את department כמפתח התווית. לדוגמה, כדי לעדכן את התווית department:shipping ל-department:logistics, מזינים את הפקודה הבאה. ‫mydataset נמצא ב-myotherproject, ולא בפרויקט שמוגדר כברירת מחדל.

    bq update \
    --set_label department:logistics \
    myotherproject:mydataset

הפלט אמור להיראות כך: 

Dataset 'myotherproject:mydataset' successfully updated.

API

כדי להוסיף תוויות או לעדכן תווית של מערך נתונים קיים, מפעילים את ה-method‏ datasets.patch ומוסיפים או מעדכנים את המאפיין labels של המשאב dataset.

השיטה datasets.update מחליפה את כל המשאב של מערך הנתונים, ולכן עדיף להשתמש בשיטה datasets.patch.

המשך

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

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח. 

import (
	"context"
	"fmt"

	"cloud.google.com/go/bigquery"
)

// addDatasetLabel demonstrates adding label metadata to an existing dataset.
func addDatasetLabel(projectID, datasetID string) error {
	// projectID := "my-project-id"
	// datasetID := "mydataset"
	ctx := context.Background()
	client, err := bigquery.NewClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigquery.NewClient: %v", err)
	}
	defer client.Close()

	ds := client.Dataset(datasetID)
	meta, err := ds.Metadata(ctx)
	if err != nil {
		return err
	}

	update := bigquery.DatasetMetadataToUpdate{}
	update.SetLabel("color", "green")
	if _, err := ds.Update(ctx, update, meta.ETag); err != nil {
		return err
	}
	return nil
}

Java

בדוגמה הזו נעשה שימוש בספריית הלקוח של Google HTTP ל-Java כדי לשלוח בקשה ל-BigQuery API.

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

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח. 

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Dataset;
import java.util.HashMap;
import java.util.Map;

// Sample to updates a label on dataset
public class LabelDataset {

  public static void runLabelDataset() {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    labelDataset(datasetName);
  }

  public static void labelDataset(String datasetName) {
    try {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

      // This example dataset starts with existing label { color: 'green' }
      Dataset dataset = bigquery.getDataset(datasetName);
      // Add label to dataset
      Map<String, String> labels = new HashMap<>();
      labels.put("color", "green");

      dataset.toBuilder().setLabels(labels).build().update();
      System.out.println("Label added successfully");
    } catch (BigQueryException e) {
      System.out.println("Label was not added. \n" + e.toString());
    }
  }
}

Node.js

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

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח. 

// Import the Google Cloud client library
const {BigQuery} = require('@google-cloud/bigquery');
const bigquery = new BigQuery();

async function labelDataset() {
  // Updates a label on a dataset.

  /**
   * TODO(developer): Uncomment the following lines before running the sample
   */
  // const datasetId = "my_dataset";

  // Retrieve current dataset metadata.
  const dataset = bigquery.dataset(datasetId);
  const [metadata] = await dataset.getMetadata();

  // Add label to dataset metadata
  metadata.labels = {color: 'green'};
  const [apiResponse] = await dataset.setMetadata(metadata);

  console.log(`${datasetId} labels:`);
  console.log(apiResponse.labels);
}

Python

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

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח. 


from google.cloud import bigquery

# Construct a BigQuery client object.
client = bigquery.Client()

# TODO(developer): Set dataset_id to the ID of the dataset to fetch.
# dataset_id = "your-project.your_dataset"

dataset = client.get_dataset(dataset_id)  # Make an API request.
dataset.labels = {"color": "green"}
dataset = client.update_dataset(dataset, ["labels"])  # Make an API request.

print("Labels added to {}".format(dataset_id))

עדכון תוויות של טבלאות ותצוגות

אחרי שיוצרים טבלה או תצוגה, אפשר לעדכן את התווית שלה בדרכים הבאות:

  • באמצעות מסוף Google Cloud
  • שימוש בפקודה bq update של כלי שורת הפקודה של BigQuery
  • שליחת קריאה ל-method ‏tables.patch ב-API
    • מכיוון שתצוגות מטופלות כמו משאבי טבלה, משתמשים ב-tables.patch כדי לשנות גם תצוגות וגם טבלאות.
  • שימוש בספריות הלקוח

ההרשאות הנדרשות

כדי לעדכן תווית של טבלה או תצוגה, צריך את הרשאת ה-IAM‏ bigquery.tables.update.

כל אחד מהתפקידים הבאים שמוגדרים מראש ב-IAM כולל את ההרשאות שצריך כדי לעדכן תווית של טבלה או תצוגה:

  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.admin

בנוסף, אם יש לכם את ההרשאה bigquery.datasets.create, אתם יכולים לעדכן תוויות של הטבלאות והתצוגות במערכי הנתונים שאתם יוצרים.

במאמר תפקידים והרשאות מוגדרים מראש תוכלו לקרוא מידע נוסף על תפקידים והרשאות של IAM ב-BigQuery.

עדכון תווית של טבלה או תצוגה

כדי לעדכן תווית של טבלה או תצוגה:

המסוף

  1. במסוף Google Cloud , בוחרים את הטבלה או התצוגה.

  2. בחלונית הפרטים, לוחצים על עריכה > עריכת הפרטים.

  3. בקטע Labels, משנים את השדות הקיימים Key או Value כדי לעדכן תווית. כדי להוסיף עוד תוויות, לוחצים על Add labels. אפשר להשתמש בכל מפתח רק פעם אחת בכל טבלה או תצוגה, אבל אפשר להשתמש באותו מפתח בטבלאות או בתצוגות בקבוצות נתונים שונות.

  4. לוחצים על Save.

SQL

משתמשים בהצהרת ה-DDL‏ ALTER TABLE SET OPTIONS כדי להגדיר את התוויות בטבלה קיימת, או בהצהרת ה-DDL‏ ALTER VIEW SET OPTIONS כדי להגדיר את התוויות בתצוגה קיימת. הגדרת תוויות מחליפה את כל התוויות הקיימות בטבלה או בתצוגה. בדוגמה הבאה מוגדרות שתי תוויות בטבלה mytable:

  1. נכנסים לדף BigQuery במסוף Google Cloud .

    כניסה ל-BigQuery

  2. בעורך השאילתות, מזינים את ההצהרה הבאה:

    ALTER TABLE mydataset.mytable
SET OPTIONS (
  labels = [('department', 'shipping'), ('cost_center', 'logistics')]);

  3. ‫לוחצים על Run.

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

BQ

כדי להוסיף תוויות או לעדכן תווית של טבלה או תצוגה, מריצים את הפקודה bq update עם הדגל set_label. חוזרים על הדגל כדי להוסיף או לעדכן כמה תוויות.

אם הטבלה או התצוגה נמצאות בפרויקט שהוא לא פרויקט ברירת המחדל, צריך להוסיף את מזהה הפרויקט למערך הנתונים בפורמט הבא: project_id:dataset.

bq update \
--set_label key:value \
project_id:dataset.table_or_view

כאשר:

  • ‫key:value תואם לצמד מפתח:ערך של תווית שרוצים להוסיף או לעדכן. אם תציינו מפתח זהה לתווית קיימת, הערך של התווית הקיימת יעודכן. המפתח חייב להיות ייחודי.
  • ‫project_id הוא מזהה הפרויקט.
  • ‫dataset היא קבוצת הנתונים שמכילה את הטבלה או התצוגה שמעדכנים.
  • ‫table_or_view הוא השם של הטבלה או התצוגה שמעדכנים.

דוגמה:

כדי לעדכן את התווית department של mytable, מזינים את הפקודה bq update ומציינים את department כמפתח התווית. לדוגמה, כדי לעדכן את התווית department:shipping ל-department:logistics ב-mytable, מזינים את הפקודה הבאה: ‫mytable נמצא ב-myotherproject, ולא בפרויקט ברירת המחדל.

    bq update \
    --set_label department:logistics \
    myotherproject:mydataset.mytable

הפלט אמור להיראות כך: 

Table 'myotherproject:mydataset.mytable' successfully updated.

API

כדי להוסיף תוויות או לעדכן תווית של טבלה או תצוגה קיימת, מפעילים את ה-method‏ tables.patch ומוסיפים או מעדכנים את המאפיין labels של משאב הטבלה.

מכיוון שתצוגות מטופלות כמו משאבי טבלה, משתמשים ב-tables.patch כדי לשנות גם תצוגות וגם טבלאות.

השיטה tables.patch עדיפה על השיטה tables.update, כי השיטה מחליפה את כל המשאב של מערך הנתונים.

המשך

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

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח. 

import (
	"context"
	"fmt"

	"cloud.google.com/go/bigquery"
)

// addTableLabel demonstrates adding Label metadata to a BigQuery table.
func addTableLabel(projectID, datasetID, tableID string) error {
	// projectID := "my-project-id"
	// datasetID := "mydataset"
	// tableID := "mytable"
	ctx := context.Background()
	client, err := bigquery.NewClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigquery.NewClient: %v", err)
	}
	defer client.Close()

	tbl := client.Dataset(datasetID).Table(tableID)
	meta, err := tbl.Metadata(ctx)
	if err != nil {
		return err
	}

	update := bigquery.TableMetadataToUpdate{}
	update.SetLabel("color", "green")
	if _, err := tbl.Update(ctx, update, meta.ETag); err != nil {
		return err
	}
	return nil
}

Java

בדוגמה הזו משתמשים בספריית הלקוח של Google HTTP ל-Java כדי לשלוח בקשה ל-BigQuery API.

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

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח. 

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Table;
import com.google.cloud.bigquery.TableId;
import java.util.HashMap;
import java.util.Map;

// Sample to adds a label to an existing table
public class LabelTable {

  public static void runLabelTable() {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    String tableName = "MY_TABLE_NAME";
    labelTable(datasetName, tableName);
  }

  public static void labelTable(String datasetName, String tableName) {
    try {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

      // This example table starts with existing label { color: 'green' }
      Table table = bigquery.getTable(TableId.of(datasetName, tableName));
      // Add label to table
      Map<String, String> labels = new HashMap<>();
      labels.put("color", "green");

      table.toBuilder().setLabels(labels).build().update();
      System.out.println("Label added successfully");
    } catch (BigQueryException e) {
      System.out.println("Label was not added. \n" + e.toString());
    }
  }
}

Node.js

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

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח. 

// Import the Google Cloud client library
const {BigQuery} = require('@google-cloud/bigquery');
const bigquery = new BigQuery();

async function labelTable() {
  // Adds a label to an existing table.

  /**
   * TODO(developer): Uncomment the following lines before running the sample.
   */
  // const datasetId = 'my_dataset';
  // const tableId = 'my_table';

  const dataset = bigquery.dataset(datasetId);
  const [table] = await dataset.table(tableId).get();

  // Retrieve current table metadata
  const [metadata] = await table.getMetadata();

  // Add label to table metadata
  metadata.labels = {color: 'green'};
  const [apiResponse] = await table.setMetadata(metadata);

  console.log(`${tableId} labels:`);
  console.log(apiResponse.labels);
}

Python

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

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח. 

# from google.cloud import bigquery
# client = bigquery.Client()
# project = client.project
# dataset_ref = bigquery.DatasetReference(project, dataset_id)
# table_ref = dataset_ref.table('my_table')
# table = client.get_table(table_ref)  # API request

assert table.labels == {}
labels = {"color": "green"}
table.labels = labels

table = client.update_table(table, ["labels"])  # API request

assert table.labels == labels

עדכון תוויות של משימות

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

עדכון תוויות ההזמנה

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

התפקידים שצריך ב-IAM

כדי לקבל את ההרשאה שנדרשת לעדכון תווית של הזמנה, צריך לבקש מהאדמין להקצות לכם את התפקיד BigQuery Resource Editor ‏(roles/bigquery.resourceEditor) ב-IAM בפרויקט הניהול. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה bigquery.reservations.update, שנדרשת כדי לעדכן תווית להזמנה.

יכול להיות שתוכלו לקבל את ההרשאה הזו גם בתפקידים בהתאמה אישית או בתפקידים מוגדרים מראש.

עדכון תווית בהזמנה

כדי לעדכן תווית של הזמנה:

המסוף

  1. נכנסים לדף BigQuery במסוף Google Cloud .

    כניסה ל-BigQuery

  2. בתפריט הניווט, לוחצים על Workload management.

  3. לוחצים על הכרטיסייה Slot reservations.

  4. מוצאים את ההזמנה שרוצים לעדכן.

  5. מרחיבים את האפשרות פעולות.

  6. לוחצים על Edit.

  7. כדי להרחיב את הקטע Advanced settings, לוחצים על החץ .

  8. מעדכנים את השמות של צמד המפתח/ערך.

  9. לוחצים על Save.

BQ

כדי לעדכן תווית של הזמנה, מריצים את הפקודה bq update עם הדגל set_label והדגל --reservation. כדי לעדכן כמה תוויות, חוזרים על הדגל.

bq update --set_label KEY:VALUE  --reservation RESERVATION_NAME

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

  • ‫KEY:VALUE: צמד מפתח/ערך של תווית שרוצים לעדכן בהזמנה. המפתח חייב להיות ייחודי. המפתחות והערכים יכולים להכיל רק אותיות קטנות, ספרות, קווים תחתונים ומקפים. כל התווים צריכים להיות בקידוד UTF-8, ואפשר להשתמש בתווים בינלאומיים. כדי לעדכן כמה תוויות בהזמנה, חוזרים על הדגל --set_label ומציינים מפתח ייחודי לכל תווית.
  • ‫RESERVATION_NAME: שם ההזמנה.

SQL

כדי לעדכן תווית של מקום שמור, משתמשים בהצהרת ה-DDL‏ ALTER RESERVATION SET OPTIONS כדי להגדיר את התוויות במקום שמור קיים. הגדרת תוויות מחליפה את כל התוויות הקיימות בהזמנה. בדוגמה הבאה מוגדרת תווית להזמנה myreservation:

  1. נכנסים לדף BigQuery במסוף Google Cloud .

    כניסה ל-BigQuery

  2. בעורך השאילתות, מזינים את ההצהרה הבאה:

    ALTER RESERVATION myreservation
SET OPTIONS (
  labels = [('sensitivity', 'high')]);

  3. ‫לוחצים על Run.

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

המרת תוויות לתגים

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

תגים יכולים להיות שימושיים במצבים שבהם אתם מתייגים משאב, אבל לא צריכים את הפורמט key:value. לדוגמה, אם יש לכם טבלה שמכילה נתוני בדיקה שמשמשים כמה קבוצות (תמיכה, פיתוח וכו'), אתם יכולים להוסיף לטבלה את התג test_data כדי לזהות אותה.

ההרשאות הנדרשות

כדי להמיר תווית לתג, צריך את הרשאות ה-IAM הבאות:

  • bigquery.datasets.update (מאפשר להמיר תווית של מערך נתונים)
  • bigquery.tables.update (מאפשר להמיר טבלה או תווית תצוגה)

כל אחד מהתפקידים הבאים שמוגדרים מראש ב-IAM כולל את ההרשאות שנדרשות כדי להמיר תווית של מערך נתונים:

  • roles/bigquery.dataOwner
  • roles/bigquery.admin

כל אחד מהתפקידים הבאים שמוגדרים מראש ב-IAM כולל את ההרשאות שדרושות כדי להמיר תווית של טבלה או תצוגה:

  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.admin

בנוסף, אם יש לכם את ההרשאה bigquery.datasets.create, אתם יכולים לעדכן את התוויות של מערכי הנתונים שאתם יוצרים, ושל הטבלאות והתצוגות במערכי הנתונים האלה.

במאמר תפקידים והרשאות מוגדרים מראש תוכלו לקרוא מידע נוסף על תפקידים והרשאות של IAM ב-BigQuery.

המרת תווית לתג

כדי להמיר תווית לתג:

המסוף

  1. במסוף Google Cloud , בוחרים את מערך הנתונים, הטבלה או התצוגה.

  2. פותחים את החלונית עריכת פרטים:

    • במערך נתונים, לוחצים על הכרטיסייה Details ואז על Edit details.
    • בטבלה או בתצוגה, לוחצים על Edit > Edit details בחלונית הפרטים.

  3. בקטע Labels, מוחקים את הערך בשדה Value של התווית שרוצים לעדכן.

  4. לוחצים על Save.

BQ

כדי להמיר תווית לתג, משתמשים בפקודה bq update עם הדגל set_label. מציינים את המפתח, מוסיפים נקודתיים ומשאירים את הערך ריק. הפעולה הזו מעדכנת תווית קיימת לתג.

bq update \
--set_label key: \
resource_id

כאשר:

  • ‫key: הוא מפתח התווית שרוצים לעדכן לתג.
  • ‫resource_id הוא שם תקין של מערך נתונים, טבלה או תצוגה. אם המשאב נמצא בפרויקט אחר מפרויקט ברירת המחדל, מוסיפים את מזהה הפרויקט בפורמט הבא: project_id:dataset.

דוגמאות:

מזינים את הפקודה הבאה כדי לשנות את התווית הקיימת test_data:development ב-mydataset לתג. ‫mydataset נמצא ב-myotherproject, ולא בפרויקט ברירת המחדל.

bq update --set_label test_data: myotherproject:mydataset

הפלט אמור להיראות כך: 

Dataset 'myotherproject:mydataset' successfully updated.

API

כדי להפוך תווית קיימת לתג, מפעילים את ה-method‏ datasets.patch או את ה-method‏ tables.patch ומחליפים את ערכי התווית במחרוזת הריקה ("") במשאב של מערך הנתונים או במשאב של הטבלה.

מכיוון שתצוגות מטופלות כמו משאבי טבלה, משתמשים ב-tables.patch כדי לשנות גם תצוגות וגם טבלאות. בנוסף, מכיוון שה-method‏ tables.update מחליפה את כל המשאב של מערך הנתונים, עדיף להשתמש ב-method‏ tables.patch.

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