Memperbarui label

Konsol

1. Di Konsol Google Cloud, pilih set data.

2. Di halaman detail set data, klik ikon pensil di sebelah kanan Label.

   

3. Pada dialog Edit label:

   • Untuk menerapkan label tambahan, klik Tambahkan label. Setiap kunci hanya dapat digunakan sekali per set data, tetapi Anda dapat menggunakan kunci yang sama dalam set data berbeda dalam project yang sama.
   • Ubah kunci atau nilai yang ada untuk mengupdate label.
   • Klik Update untuk menyimpan perubahan.

SQL

Gunakan pernyataan DDL ALTER SCHEMA SET OPTIONS untuk menetapkan label pada set data yang ada. Menetapkan label akan menimpa label yang ada di set data. Contoh berikut menetapkan satu label pada set data mydataset:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di editor kueri, masukkan pernyataan berikut:

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

3. Klik play_circle Run.

Untuk informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

bq

Untuk menambahkan label lain atau memperbarui label set data, berikan perintah bq update dengan flag set_label. Ulangi flag tersebut untuk menambahkan atau memperbarui beberapa label.

Jika set data berada dalam project selain project default Anda, tambahkan project ID ke set data dalam format berikut: [PROJECT_ID]:[DATASET].

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

Dengan keterangan:

• key:value berkaitan dengan pasangan nilai kunci untuk label yang ingin Anda tambahkan atau perbarui. Jika Anda menentukan kunci yang sama dengan label yang ada, nilai untuk label yang ada akan diperbarui. Kunci harus unik.
• project_id adalah project ID Anda.
• dataset adalah set data yang Anda perbarui.

Contoh:

Untuk memperbarui label department pada mydataset, masukkan perintah bq update dan tentukan department sebagai kunci label. Misalnya, untuk memperbarui label department:shipping menjadi department:logistics, masukkan perintah berikut. mydataset ada di myotherproject, bukan di project default Anda.

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

Outputnya akan terlihat seperti berikut.

Dataset 'myotherproject:mydataset' successfully updated.

API

Untuk menambahkan label lain atau memperbarui label untuk set data yang ada, panggil metode datasets.patch dan tambahkan ke atau perbarui properti labels untuk resource set data.

Karena metode datasets.update menggantikan seluruh resource set data, sebaiknya gunakan metode datasets.patch.

Go

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

Contoh ini menggunakan Library Klien HTTP Google untuk Java untuk mengirim permintaan ke BigQuery API.

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

// 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

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))

Konsol

1. Di Konsol Google Cloud, pilih tabel atau tampilan.

2. Klik tab Detail, lalu klik ikon pensil di sebelah kanan Label.

3. Pada dialog Edit label:

   • Untuk menerapkan label tambahan, klik Tambahkan label. Setiap kunci hanya dapat digunakan sekali per tabel atau tampilan, tetapi Anda dapat menggunakan kunci yang sama pada tabel atau tampilan di set data yang berbeda.
   • Ubah kunci atau nilai yang ada untuk mengupdate label.
   • Klik Update untuk menyimpan perubahan.

SQL

Gunakan Pernyataan DDL ALTER TABLE SET OPTIONS untuk menetapkan label di tabel yang sudah ada, atau Pernyataan DDL ALTER VIEW SET OPTIONS untuk menetapkan label pada tampilan yang sudah ada. Menetapkan label akan menimpa label yang ada di tabel atau tampilan. Contoh berikut menetapkan dua label pada tabel mytable:

1. Di Konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di editor kueri, masukkan pernyataan berikut:

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

3. Klik play_circle Run.

Untuk informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

bq

Untuk menambahkan label lain atau memperbarui label tabel atau tampilan, berikan perintah bq update dengan flag set_label. Ulangi flag tersebut untuk menambahkan atau memperbarui beberapa label.

Jika tabel atau tampilan berada dalam project selain project default Anda, tambahkan project ID ke set data dalam format berikut: project_id:dataset.

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

Dengan keterangan:

• key:value berkaitan dengan pasangan nilai kunci untuk label yang ingin Anda tambahkan atau perbarui. Jika Anda menentukan kunci yang sama dengan label yang ada, nilai untuk label yang ada akan diperbarui. Kunci harus unik.
• project_id adalah project ID Anda.
• dataset adalah set data yang berisi tabel atau tampilan yang Anda perbarui.
• table_or_view adalah nama tabel atau tampilan yang Anda perbarui.

Contoh:

Untuk memperbarui label department untuk mytable, masukkan perintah bq update dan tentukan department sebagai kunci label. Misalnya, untuk memperbarui label department:shipping menjadi department:logistics untuk mytable, masukkan perintah berikut. mytable ada di myotherproject, bukan di project default Anda.

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

Outputnya akan terlihat seperti berikut:

Table 'myotherproject:mydataset.mytable' successfully updated.

API

Untuk menambahkan label atau memperbarui label untuk tabel atau tampilan yang sudah ada, panggil metode tables.patch dan tambahkan ke atau perbarui properti labels untuk resource tabel.

Karena tampilan diperlakukan seperti resource tabel, Anda harus menggunakan metode tables.patch untuk mengubah tampilan dan tabel.

Karena metode tables.update menggantikan seluruh resource set data, sebaiknya gunakan metode tables.patch.

Go

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

Contoh ini menggunakan Library Klien HTTP Google untuk Java untuk mengirim permintaan ke BigQuery API.

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

// 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

# 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

Konsol

1. Di Konsol Google Cloud, pilih set data, tabel, atau tampilan.

2. Untuk set data, halaman detail set data akan terbuka otomatis. Untuk tabel dan tampilan, klik Detail untuk membuka halaman detail.

   

3. Pada halaman detail, klik ikon pensil di sebelah kanan Label.

   

4. Pada dialog Edit label:

   • Hapus nilai untuk label yang ada.
   • Klik Perbarui.

bq

Untuk mengonversi label menjadi tag, gunakan perintah bq update dengan flag set_label. Tentukan kunci, diikuti dengan titik dua, tetapi biarkan nilainya tidak ditentukan. Tindakan ini akan memperbarui label yang ada menjadi sebuah tag.

bq update \
--set_label key: \
resource_id

Dengan keterangan:

• key: adalah kunci label yang ingin Anda perbarui menjadi tag.
• resource_id adalah nama set data, tabel, atau tampilan yang valid. Jika resource berada dalam project selain project default Anda, tambahkan project ID dalam format berikut: project_id:dataset.

Contoh:

Masukkan perintah berikut untuk mengubah label test_data:development yang ada di mydataset menjadi tag. mydataset ada di myotherproject, bukan di project default Anda.

bq update --set_label test_data: myotherproject:mydataset

Outputnya akan terlihat seperti berikut:

Dataset 'myotherproject:mydataset' successfully updated.

API

Untuk mengubah label yang ada menjadi tag, panggil metode datasets.patch atau metode tables.patch dan ganti nilai label dengan string kosong ("") di resource set data atau resource tabel.

Karena tampilan diperlakukan seperti resource tabel, Anda harus menggunakan metode tables.patch untuk mengubah tampilan dan tabel. Selain itu, karena metode tables.update menggantikan seluruh resource set data, sebaiknya gunakan metode tables.patch.