Gestionar vistas lógicas

Consola

1. En el panel Explorador, expande tu proyecto y tu conjunto de datos, y selecciona la vista.

2. Haga clic en la pestaña Detalles.

3. Encima del cuadro Consulta, haz clic en el botón Editar consulta. En el cuadro de diálogo que aparece, haz clic en Abrir.

   

4. Edita la consulta de SQL en el cuadro Editor de consultas y, a continuación, haz clic en Guardar vista.

   

5. Comprueba que todos los campos del cuadro de diálogo Guardar vista sean correctos y, a continuación, haz clic en Guardar.

bq

Ejecuta el comando bq update con la marca --view. Para usar GoogleSQL o actualizar el dialecto de la consulta de SQL antiguo a GoogleSQL, incluye la marca --use_legacy_sql y asígnale el valor false.

Si tu consulta hace referencia a recursos de funciones definidas por el usuario externas almacenadas en Cloud Storage o en archivos locales, usa la marca --view_udf_resource para especificar esos recursos. Aquí no se muestra la marca --view_udf_resource. Para obtener más información sobre cómo usar las funciones definidas por el usuario, consulta el artículo Funciones definidas por el usuario de GoogleSQL.

Si vas a actualizar una vista en un proyecto que no sea el predeterminado, añade el ID del proyecto al nombre del conjunto de datos con el siguiente formato: project_id:dataset.

bq update \
    --use_legacy_sql=false \
    --view_udf_resource=path_to_file \
    --view='query' \
    project_id:dataset.view

Haz los cambios siguientes:

• path_to_file: el URI o la ruta del sistema de archivos local a un archivo de código que se va a cargar y evaluar inmediatamente como un recurso de función definida por el usuario que usa la vista. Repite la marca para especificar varios archivos.
• query: una consulta de GoogleSQL válida
• project_id: tu ID de proyecto
• dataset: el nombre del conjunto de datos que contiene la vista que estás actualizando
• view: el nombre de la vista que quieres actualizar

Ejemplos

Introduce el siguiente comando para actualizar la consulta de SQL de una vista llamada myview en mydataset. mydataset está en tu proyecto predeterminado. La consulta de ejemplo que se ha usado para actualizar la vista consulta datos del conjunto de datos público USA Name Data.

bq update \
    --use_legacy_sql=false \
    --view \
    'SELECT
      name,
      number
    FROM
      `bigquery-public-data.usa_names.usa_1910_current`
    WHERE
      gender = "M"
    ORDER BY
      number DESC;' \
    mydataset.myview

Introduce el siguiente comando para actualizar la consulta de SQL de una vista llamada myview en mydataset. mydataset está en myotherproject, no en tu proyecto predeterminado. La consulta de ejemplo que se usa para actualizar la vista consulta datos del conjunto de datos público USA Name Data.

bq update \
    --use_legacy_sql=false \
    --view \
    'SELECT
      name,
      number
    FROM
      `bigquery-public-data.usa_names.usa_1910_current`
    WHERE
      gender = "M"
    ORDER BY
      number DESC;' \
    myotherproject:mydataset.myview

API

Para actualizar una vista, llama al método tables.patch con un recurso de tabla que contenga una propiedad view actualizada. Como el método tables.update sustituye todo el recurso de la tabla, se recomienda usar el método tables.patch.

Go

import (
	"context"
	"fmt"

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

// updateView demonstrates updating the query metadata that defines a logical view.
func updateView(projectID, datasetID, viewID string) error {
	// projectID := "my-project-id"
	// datasetID := "mydataset"
	// viewID := "myview"
	ctx := context.Background()
	client, err := bigquery.NewClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigquery.NewClient: %v", err)
	}
	defer client.Close()

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

	newMeta := bigquery.TableMetadataToUpdate{
		// This example updates a view into the shakespeare dataset to exclude works named after kings.
		ViewQuery: "SELECT word, word_count, corpus, corpus_date FROM `bigquery-public-data.samples.shakespeare` WHERE corpus NOT LIKE '%king%'",
	}

	if _, err := view.Update(ctx, newMeta, meta.ETag); err != nil {
		return err
	}
	return nil
}

Java

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.TableId;
import com.google.cloud.bigquery.TableInfo;
import com.google.cloud.bigquery.ViewDefinition;

// Sample to update query on a view
public class UpdateViewQuery {

  public static void runUpdateViewQuery() {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    String tableName = "MY_TABLE_NAME";
    String viewName = "MY_VIEW_NAME";
    String updateQuery =
        String.format("SELECT TimestampField, StringField FROM %s.%s", datasetName, tableName);
    updateViewQuery(datasetName, viewName, updateQuery);
  }

  public static void updateViewQuery(String datasetName, String viewName, String query) {
    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();

      // Retrieve existing view metadata
      TableInfo viewMetadata = bigquery.getTable(TableId.of(datasetName, viewName));

      // Update view query
      ViewDefinition viewDefinition = viewMetadata.getDefinition();
      viewDefinition.toBuilder().setQuery(query).build();

      // Set metadata
      bigquery.update(viewMetadata.toBuilder().setDefinition(viewDefinition).build());

      System.out.println("View query updated successfully");
    } catch (BigQueryException e) {
      System.out.println("View query was not updated. \n" + e.toString());
    }
  }
}

Node.js

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

async function updateViewQuery() {
  // Updates a view named "my_existing_view" in "my_dataset".

  /**
   * TODO(developer): Uncomment the following lines before running the sample.
   */
  // const datasetId = "my_existing_dataset"
  // const tableId = "my_existing_table"
  const dataset = await bigquery.dataset(datasetId);

  // This example updates a view into the USA names dataset to include state.
  const newViewQuery = `SELECT name, state 
  FROM \`bigquery-public-data.usa_names.usa_1910_current\`
  LIMIT 10`;

  // Retrieve existing view
  const [view] = await dataset.table(tableId).get();

  // Retrieve existing view metadata
  const [metadata] = await view.getMetadata();

  // Update view query
  metadata.view = newViewQuery;

  // Set metadata
  await view.setMetadata(metadata);

  console.log(`View ${tableId} updated.`);
}

Python

from google.cloud import bigquery

client = bigquery.Client()

view_id = "my-project.my_dataset.my_view"
source_id = "my-project.my_dataset.my_table"
view = bigquery.Table(view_id)

# The source table in this example is created from a CSV file in Google
# Cloud Storage located at
# `gs://cloud-samples-data/bigquery/us-states/us-states.csv`. It contains
# 50 US states, while the view returns only those states with names
# starting with the letter 'M'.
view.view_query = f"SELECT name, post_abbr FROM `{source_id}` WHERE name LIKE 'M%'"

# Make an API request to update the query property of the view.
view = client.update_table(view, ["view_query"])
print(f"Updated {view.table_type}: {str(view.reference)}")

Consola

1. En el panel de navegación, selecciona la vista que quieras.

2. En la página Ver detalles, haga clic en la pestaña Detalles.

3. A la derecha de Ver información, haz clic en el icono de edición (lápiz).

4. En el cuadro de diálogo Ver información, en Caducidad de la vista, haz clic en Especificar fecha.

5. En el selector de fecha, introduce la fecha y la hora de vencimiento y, a continuación, haz clic en Aceptar.

6. Haz clic en Actualizar. La hora de vencimiento actualizada aparece en la sección Ver información.

SQL

Usa la ALTER VIEW SET OPTIONSdeclaración de DDL:

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, introduce la siguiente instrucción:

    ALTER VIEW DATASET_ID.MY_VIEW
    SET OPTIONS (
     expiration_timestamp = TIMESTAMP('NEW_TIMESTAMP'));

   Haz los cambios siguientes:

   • DATASET_ID: el ID del conjunto de datos que contiene la vista
   • MY_VIEW: el nombre de la vista que se va a actualizar
   • NEW_TIMESTAMP: un valor TIMESTAMP

3. Haz clic en play_circle Ejecutar.

Para obtener más información sobre cómo ejecutar consultas, consulta Ejecutar una consulta interactiva.

bq

Ejecuta el comando bq update con la marca --expiration. Si vas a actualizar una vista en un proyecto que no sea el predeterminado, añade el ID del proyecto al nombre del conjunto de datos con el siguiente formato: project_id:dataset.

bq update \
    --expiration integer \
    project_id:dataset.view

Sustituye lo siguiente:

• integer: el tiempo de vida predeterminado (en segundos) de la tabla. El valor mínimo es de 3600 segundos (una hora). La hora de vencimiento se calcula como la hora actual más el valor entero.
• project_id: tu ID de proyecto
• dataset: el nombre del conjunto de datos que contiene la vista que quieres actualizar
• view: el nombre de la vista que quieres actualizar

Ejemplos

Introduce el siguiente comando para actualizar el tiempo de vencimiento de myview en mydataset a 5 días (432.000 segundos). mydataset está en tu proyecto predeterminado.

bq update \
    --expiration 432000 \
    mydataset.myview

Introduce el siguiente comando para actualizar el tiempo de vencimiento de myview en mydataset a 5 días (432.000 segundos). mydataset está en myotherproject, no en tu proyecto predeterminado.

bq update \
    --expiration 432000 \
    myotherproject:mydataset.myview

API

Llama al método tables.patch y usa la propiedad expirationTime en el recurso de tabla. Como el método tables.update sustituye todo el recurso de la tabla, se recomienda usar el método tables.patch. Cuando usas la API REST, el vencimiento de la vista se expresa en milisegundos.

Go

import (
	"context"
	"fmt"
	"time"

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

// updateTableExpiration demonstrates setting the table expiration of a table to a specific point in time
// in the future, at which time it will be deleted.
func updateTableExpiration(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()

	tableRef := client.Dataset(datasetID).Table(tableID)
	meta, err := tableRef.Metadata(ctx)
	if err != nil {
		return err
	}
	update := bigquery.TableMetadataToUpdate{
		ExpirationTime: time.Now().Add(time.Duration(5*24) * time.Hour), // table expiration in 5 days.
	}
	if _, err = tableRef.Update(ctx, update, meta.ETag); err != nil {
		return err
	}
	return nil
}

Java

Table beforeTable = bigquery.getTable(datasetName, tableName);

// Set table to expire 5 days from now.
long expirationMillis = DateTime.now().plusDays(5).getMillis();
TableInfo tableInfo = beforeTable.toBuilder()
        .setExpirationTime(expirationMillis)
        .build();
Table afterTable = bigquery.update(tableInfo);

Node.js

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

async function updateTableExpiration() {
  // Updates a table's expiration.

  /**
   * TODO(developer): Uncomment the following lines before running the sample.
   */
  // const datasetId = 'my_dataset', // Existing dataset
  // const tableId = 'my_table', // Existing table
  // const expirationTime = Date.now() + 1000 * 60 * 60 * 24 * 5 // 5 days from current time in ms

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

  // Set new table expiration to 5 days from current time
  metadata.expirationTime = expirationTime.toString();
  const [apiResponse] = await table.setMetadata(metadata);

  const newExpirationTime = apiResponse.expirationTime;
  console.log(`${tableId} expiration: ${newExpirationTime}`);
}

Python

El proceso para actualizar la fecha de vencimiento de una vista es el mismo que el de una tabla.

from google.cloud import bigquery

client = bigquery.Client()

# TODO(dev): Change table_id to the full name of the table you want to update.
table_id = "your-project.your_dataset.your_table_name"

# TODO(dev): Set table to expire for desired days days from now.
expiration = datetime.datetime.now(datetime.timezone.utc) + datetime.timedelta(
    days=5
)
table = client.get_table(table_id)  # Make an API request.
table.expires = expiration
table = client.update_table(table, ["expires"])  # API request

print(f"Updated {table_id}, expires {table.expires}.")

Consola

No puedes añadir una descripción cuando creas una vista con la consola Google Cloud . Una vez creada la vista, puede añadir una descripción en la página Detalles.

1. En el panel Explorador, expande tu proyecto y tu conjunto de datos, y selecciona la vista.

2. Haga clic en la pestaña Detalles.

3. Haz clic en el icono de lápiz situado junto a Descripción.

   

4. Escribe una descripción en el cuadro de diálogo. Haz clic en Actualizar para guardar la nueva descripción.

SQL

Usa la ALTER VIEW SET OPTIONSdeclaración de DDL:

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, introduce la siguiente instrucción:

    ALTER VIEW DATASET_ID.MY_VIEW
    SET OPTIONS (
     description = 'NEW_DESCRIPTION');

   Haz los cambios siguientes:

   • DATASET_ID: el ID del conjunto de datos que contiene la vista
   • MY_VIEW: el nombre de la vista que se va a actualizar
   • NEW_DESCRIPTION: la nueva descripción de la vista

3. Haz clic en play_circle Ejecutar.

Para obtener más información sobre cómo ejecutar consultas, consulta Ejecutar una consulta interactiva.

bq

Ejecuta el comando bq update con la marca --description. Si vas a actualizar una vista en un proyecto que no sea el predeterminado, añade el ID del proyecto al nombre del conjunto de datos con el siguiente formato: [PROJECT_ID]:[DATASET].

bq update \
    --description "description" \
    project_id:dataset.view

Haz los cambios siguientes:

• description: el texto que describe la vista entre comillas
• project_id: tu ID de proyecto.
• dataset: el nombre del conjunto de datos que contiene la vista que quieres actualizar
• view: el nombre de la vista que quieres actualizar

Ejemplos

Introduce el siguiente comando para cambiar la descripción de myview en mydataset a "Descripción de myview". mydataset está en tu proyecto predeterminado.

bq update \
    --description "Description of myview" \
    mydataset.myview

Introduce el siguiente comando para cambiar la descripción de myview en mydataset a "Descripción de myview". mydataset está en myotherproject, no en tu proyecto predeterminado.

bq update \
    --description "Description of myview" \
    myotherproject:mydataset.myview

API

Llama al método tables.patch y usa la propiedad description para actualizar la descripción de la vista en el recurso de tabla. Como el método tables.update sustituye todo el recurso de tabla, se recomienda usar el método tables.patch.

Go