管理视图

本文档介绍了如何在 BigQuery 中管理视图。您可以通过以下方式管理 BigQuery 视图：

• 复制视图
• 重命名视图
• 删除视图

复制视图

目前，您只能使用 Cloud Console 复制视图。

系统不支持使用经典版网页界面、CLI、REST API 或客户端库复制视图。如有相应需要，您必须在目标数据集中重新创建视图。为了帮助您重新创建视图，您可以使用 CLI 或经典版网页界面复制视图的 SQL 查询。

所需权限

如需在 Cloud Console 中复制视图，您至少必须具有以下权限。

对于源数据集：

• bigquery.tables.get，用于复制视图的元数据
• bigquery.tables.getData，用于复制视图的 SQL 查询

如需访问视图的 SQL 查询引用的表，可能还需要其他权限，例如 bigquery.tables.getData。

对于目标数据集：

• bigquery.tables.create，用于在目标数据集中创建视图的副本

以下预定义 Cloud IAM 角色可提供 bigquery.tables.create、bigquery.tables.get 和 bigquery.tables.getData 权限：

• bigquery.dataEditor
• bigquery.dataOwner
• bigquery.admin

此外，如果用户具有 bigquery.datasets.create 权限，则当该用户创建数据集时，系统会为其授予该数据集的 bigquery.dataOwner 访问权限。具有 bigquery.dataOwner 访问权限的用户可以复制源数据集中的视图，但如果目标数据集不是由该用户创建的，则该用户还需要对目标数据集的访问权限。

注意：复制视图不需要 bigquery.jobs.create 权限。复制视图时，Cloud Console 不会生成复制作业。

如需详细了解 BigQuery 中的 Cloud IAM 角色和权限，请参阅预定义的角色和权限。

复制视图

要复制视图，请执行以下操作：

控制台

1. 在导航窗格中，选择视图。

2. 在窗口的右侧，点击复制视图。

3. 在复制视图对话框中，执行以下操作：

   • 在来源 (Source) 部分中，验证您的项目名称、数据集名称和表名称是否正确无误。

   • 在目标 (Destination) 部分中执行如下设置：

     • 对于项目名称，选择要将视图复制到哪个项目。
     • 对于数据集名称，选择要包含所复制视图的数据集。
     • 对于表名称，输入该视图的名称。您可以在框中输入新的视图名称，以便更改视图名称。如果要输入新名称，这个新名称必须遵循视图命名规则。

     

   • 点击复制。

经典版界面

经典版网页界面不支持复制视图。如有相应需要，您必须在目标数据集中重新创建视图。为了帮助您重新创建视图，您可以复制用于定义视图的 SQL 查询。

要复制定义视图的 SQL 查询，请执行以下操作：

1. 在界面导航窗格中，选择视图。

2. 在 View Details 面板中，点击 Details。

3. 复制 Query 框中的文本。

CLI

bq 命令行工具不支持复制视图。如有相应需要，您必须在目标数据集中重新创建视图。为了帮助您重新创建视图，您可以复制用于定义视图的 SQL 查询。

要复制定义视图的 SQL 查询，请执行 bq show 命令。可以使用 --format 标志控制输出。如果您要获取非默认项目中的视图信息，请按以下格式将相应项目 ID 添加到数据集中：project_id:dataset。要将视图属性写入文件，请在命令中添加 > path_to_file。

bq show \
--format=prettyjson \
project_id:dataset.view > path_to_file

其中：

• project_id 是您的项目 ID。
• dataset 是数据集的名称。
• view 是视图的名称。
• path_to_file 是本地机器上输出文件的路径。

示例：

输入以下命令可显示 mydataset 中有关 myview 的信息。mydataset 在默认项目中。

bq show --format=prettyjson mydataset.myview

输入以下命令可显示 mydataset 中有关 myview 的信息。mydataset 在 myotherproject 中，不在默认项目中。视图属性会写入本地文件 /tmp/myview.json。

bq show \
--format=prettyjson \
myotherproject:mydataset.myview > /tmp/myview.json

API

REST API 不支持复制视图。如有相应需要，您必须在目标数据集中重新创建视图。有关使用 REST API 创建视图的信息，请参阅创建视图。

重命名视图

目前，只有在使用 Cloud Console 复制视图时才能重命名视图。如需了解如何在复制视图时对视图进行重命名，请参阅复制视图。

系统不支持使用经典版网页界面、CLI、API 或客户端库更改现有视图的名称。如有相应需要，您必须使用新名称重新创建视图。

删除视图

您可以通过以下方式删除视图：

• 使用 Cloud Console 或经典版 BigQuery 网页界面
• 使用命令行工具的 bq rm 命令
• 调用 tables.delete API 方法

目前，无论使用何种方法，您每次只能删除一个视图。

若要在指定的时间段后自动删除视图，请设置数据集级别的默认到期时间，或在创建视图时设置到期时间。

注意：删除视图的操作无法撤消。

所需权限

如需删除视图，您至少必须具有 bigquery.tables.delete 和 bigquery.tables.get 权限。以下预定义 Cloud IAM 角色具有 bigquery.tables.delete 和 bigquery.tables.get 权限：

• bigquery.dataOwner
• bigquery.dataEditor
• bigquery.admin

此外，如果用户具有 bigquery.datasets.create 权限，则当该用户创建数据集时，系统会为其授予该数据集的 bigquery.dataOwner 访问权限。具备 bigquery.dataOwner 访问权限的用户可以在数据集中删除视图。

如需详细了解 BigQuery 中的 Cloud IAM 角色和权限，请参阅预定义的角色和权限。

删除视图

删除视图的方法如下：

控制台

1. 在资源面板中选择视图。点击窗口右侧的删除视图。

2. 在对话框中键入视图的名称，然后点击删除进行确认。

经典版界面

1. 在导航栏中，点击视图名称旁的向下箭头图标 ，再点击 Delete view。

2. 出现提示时，点击 OK 以确认删除该查询。

CLI

使用带有 --table 标志（或 -t 快捷方式）的 bq rm 命令删除视图。使用 CLI 移除视图时，您必须确认该操作。您可以使用 --force 标志（或 -f 快捷方式）跳过确认。

如果该视图属于非默认项目中的数据集，请按以下格式将相应项目 ID 添加到数据集名称中：project_id:dataset。

bq rm \
-f \
-t \
project_id:dataset.view

其中：

• project_id 是项目 ID。
• dataset 是包含该表的数据集的名称。
• view 是您要删除的视图的名称。

示例：

输入以下命令可从 mydataset 删除 myview。mydataset 在默认项目中。

bq rm -t mydataset.myview

输入以下命令可从 mydataset 删除 myview。mydataset 在 myotherproject 中，不在默认项目中。

bq rm -t myotherproject:mydataset.myview

输入以下命令可从 mydataset 删除 myview。mydataset 在默认项目中。该命令使用 -f 快捷方式绕过确认。

bq rm -f -t mydataset.myview

注意：您可以输入 bq ls dataset CLI 命令以确认视图是否已从数据集中移除。

API

调用 tables.delete API 方法并使用 tableId 参数指定要删除的视图。

C#

试用此示例之前，请按照《BigQuery 快速入门：使用客户端库》中的 C# 设置说明进行操作。 如需了解详情，请参阅 BigQuery C# API 参考文档。

在 GitHub 上查看 反馈

using Google.Cloud.BigQuery.V2;
using System;

public class BigQueryDeleteTable
{
    public void DeleteTable(
        string projectId = "your-project-id",
        string datasetId = "your_dataset_id",
        string tableId = "your_table_id"
    )
    {
        BigQueryClient client = BigQueryClient.Create(projectId);
        client.DeleteTable(datasetId, tableId);
        Console.WriteLine($"Table {tableId} deleted.");
    }
}

Go

尝试此示例之前，请按照 BigQuery 快速入门：使用客户端库中的 Go 设置说明进行操作。如需了解详情，请参阅 BigQuery Go API 参考文档。

在 GitHub 上查看 反馈

import (
	"context"
	"fmt"

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

// deleteTable demonstrates deletion of a BigQuery table.
func deleteTable(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)
	}

	table := client.Dataset(datasetID).Table(tableID)
	if err := table.Delete(ctx); err != nil {
		return err
	}
	return nil
}

Java

尝试此示例之前，请按照《BigQuery 快速入门：使用客户端库》中的 Java 设置说明进行操作。如需了解详情，请参阅 BigQuery Java API 参考文档。

在 GitHub 上查看 反馈

TableId tableId = TableId.of(projectId, datasetName, tableName);
boolean deleted = bigquery.delete(tableId);
if (deleted) {
  // the table was deleted
} else {
  // the table was not found
}

Node.js

尝试此示例之前，请按照 BigQuery 快速入门：使用客户端库中的 Node.js 设置说明进行操作。如需了解详情，请参阅 BigQuery Node.js API 参考文档。

在 GitHub 上查看 反馈

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

async function deleteTable() {
  // Deletes "my_table" from "my_dataset".

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

  // Delete the table
  await bigquery
    .dataset(datasetId)
    .table(tableId)
    .delete();

  console.log(`Table ${tableId} deleted.`);
}

PHP

试用此示例之前，请按照《BigQuery 快速入门：使用客户端库》中的 PHP 设置说明进行操作。 如需了解详情，请参阅 BigQuery PHP API 参考文档。

在 GitHub 上查看 反馈

use Google\Cloud\BigQuery\BigQueryClient;

/** Uncomment and populate these variables in your code */
// $projectId = 'The Google project ID';
// $datasetId = 'The BigQuery dataset ID';
// $tableId = 'The BigQuery table ID';

$bigQuery = new BigQueryClient([
    'projectId' => $projectId,
]);
$dataset = $bigQuery->dataset($datasetId);
$table = $dataset->table($tableId);
$table->delete();
printf('Deleted table %s.%s' . PHP_EOL, $datasetId, $tableId);

Python

尝试此示例之前，请按照《BigQuery 快速入门：使用客户端库》中的 Python 设置说明进行操作。如需了解详情，请参阅 BigQuery Python API 参考文档。

在 GitHub 上查看 反馈

# TODO(developer): Import the client library.
# from google.cloud import bigquery

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

# TODO(developer): Set table_id to the ID of the table to fetch.
# table_id = 'your-project.your_dataset.your_table'

# If the table does not exist, delete_table raises
# google.api_core.exceptions.NotFound unless not_found_ok is True.
client.delete_table(table_id, not_found_ok=True)  # Make an API request.
print("Deleted table '{}'.".format(table_id))

Ruby

试用此示例之前，请按照《BigQuery 快速入门：使用客户端库》中的 Ruby 设置说明进行操作。 如需了解详情，请参阅 BigQuery Ruby API 参考文档。

在 GitHub 上查看 反馈

require "google/cloud/bigquery"

def delete_table dataset_id = "my_dataset_id", table_id = "my_table_id"
  bigquery = Google::Cloud::Bigquery.new
  dataset  = bigquery.dataset dataset_id
  table    = dataset.table table_id

  table.delete

  puts "Table #{table_id} deleted."
end

后续步骤

• 要了解如何创建视图，请参阅创建视图。
• 如需了解如何创建授权视图，请参阅创建授权视图。
• 如需了解如何列出视图，请参阅列出视图。
• 如需了解如何获取视图元数据，请参阅获取视图相关信息。
• 如需了解如何更新视图，请参阅更新视图。