管理视图

管理视图

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

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

复制视图

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

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

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

Console

在界面导航窗格中，选择视图。
在窗口的右侧，点击复制视图。
在复制视图对话框中，执行以下操作：
- 在来源 (Source) 部分中，验证您的项目名称、数据集名称和表名称是否正确无误。
- 在目标 (Destination) 部分中执行如下设置：
  - 对于项目名称，选择要将视图复制到哪个项目。
  - 对于数据集名称，选择要包含所复制视图的数据集。
  - 对于表名称，输入该视图的名称。您可以在框中输入新的视图名称，以便更改视图名称。如果要输入新名称，这个新名称必须遵循视图命名规则。
- 点击复制。

经典版界面

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

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

在界面导航窗格中，选择视图。
在 View Details 面板中，点击 Details。
将文字复制到查询框中。

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 创建视图的信息，请参阅创建视图。

重命名视图

目前，只有在使用 GCP Console 复制视图时才能重命名视图。有关在复制视图时对视图进行重命名的说明，请参阅复制视图。

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

删除视图

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

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

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

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

所需权限

删除视图所需的权限与删除表所需的权限相同，也就是说，您必须具有数据集级层的 OWNER 访问权限，或者必须分配有包含 bigquery.tables.delete 权限的项目级层 IAM 角色。以下预定义的项目级层 IAM 角色包含 bigquery.tables.delete 权限：

分配有预定义的项目级层角色的用户可以删除该项目中任何数据集内的视图。在数据集级层分配有 OWNER 权限的用户只能删除该数据集中的视图。

此外，由于 bigquery.user 角色具有 bigquery.datasets.create 权限，因此分配有 bigquery.user 角色的用户可以删除该用户创建的任何数据集中的视图。在分配有 bigquery.user 角色的用户创建数据集后，系统将为该用户授予对该数据集的 OWNER 访问权限。凭借对数据集的 OWNER 访问权限，用户可以完全控制该数据集以及其中的所有表和视图。

要详细了解 BigQuery 中的 IAM 角色和权限，请参阅访问权限控制。要详细了解数据集级层角色，请参阅数据集的初始角色。

删除视图

删除视图的方法如下：

经典版界面

在 Resources 面板中选择视图。点击窗口右侧的 Delete view。
在对话框中键入视图的名称，然后点击 Delete 进行确认。

经典版界面

在导航栏中，点击视图名称旁的向下箭头图标，再点击 Delete view。
出现提示时，点击 OK 以确认删除。

命令行

使用带有 --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

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 上查看反馈

// To run this sample, you will need to create (or reuse) a context and
// an instance of the bigquery client.  For example:
// import "cloud.google.com/go/bigquery"
// ctx := context.Background()
// client, err := bigquery.NewClient(ctx, "your-project-id")
table := client.Dataset(datasetID).Table(tableID)
if err := table.Delete(ctx); err != nil {
	return err
}

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

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";

  // Create a client
  const bigqueryClient = new BigQuery();

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

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

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 上查看反馈

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

后续步骤

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

此页内容是否有用？请给出您的反馈和评价：

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

上次更新日期：八月 19, 2019

复制视图

Console

经典版界面

CLI

API

重命名视图

删除视图

所需权限

删除视图

经典版界面

经典版界面

命令行

API

C#

Go

Java

Node.js

PHP

Python

Ruby

后续步骤

发送以下问题的反馈：