Trabaja con transferencias

Después de crear una transferencia con el Servicio de transferencia de datos de BigQuery, puedes hacer lo siguiente:

  • Obtener información sobre una configuración de transferencia
  • Enumerar configuraciones de transferencia
  • Ver el historial de ejecución de una transferencia
  • Ver detalles de la ejecución de transferencia, como los mensajes de registro
  • Actualizar una transferencia
  • Configurar un reabastecimiento
  • Actualizar credenciales
  • Inhabilitar una transferencia
  • Borrar una transferencia

Obtén información sobre las transferencias

Después de crear una transferencia, puedes obtener información sobre la configuración de la transferencia. La configuración incluye los valores que proporcionaste cuando creaste la transferencia.

Permisos necesarios

Para obtener información sobre una transferencia, se necesitan permisos bigquery.transfers.get. Las siguientes funciones predefinidas de Cloud IAM incluyen los permisos bigquery.transfers.get:

  • bigquery.admin
  • bigquery.user

Un usuario al que se le otorgó el permiso bigquery.transfers.get puede ver información sobre todas las transferencias de un proyecto.

Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta la página de la referencia de control de acceso.

Obtén información sobre una transferencia

Para obtener información sobre una configuración de la transferencia, sigue estos pasos:

IU clásica

  1. Ve a la IU web de BigQuery.

    Ir a la IU web de BigQuery

  2. Haz clic en Transferencias.

  3. En la página Transferencias, haz clic en la transferencia apropiada en la lista.

  4. La configuración de transferencia aparece en la página de propiedades sobre el historial de ejecución. En el siguiente ejemplo, se muestran las propiedades de configuración para una transferencia de Google Ads.

    configuración de la transferencia

CLI

Ingresa el comando bq show y proporciona el nombre del recurso de la configuración de la transferencia. La marca --format se puede usar para controlar el formato de salida.

bq show \
--format=prettyjson \
--transfer_config resource_name

Donde:

  • resource_name es el nombre del recurso de la transferencia (también conocido como la configuración de la transferencia). Si no conoces el nombre del recurso de la transferencia, ejecuta el comando bq ls --transfer_config --transfer_location=location para ver una lista de todas las transferencias.

Por ejemplo, ingresa el siguiente comando para mostrar la configuración de la transferencia projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7.

bq show \
--format=prettyjson \
--transfer_config projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

Usa el método projects.locations.transferConfigs.get y proporciona la configuración de la transferencia con el parámetro name.

Haz una lista de las opciones de configuración de la transferencia

Permisos necesarios

Para hacer una lista de las opciones de configuración de la transferencia en un proyecto, es necesario contar con permisos bigquery.transfers.get. Las siguientes funciones predefinidas de Cloud IAM incluyen los permisos bigquery.transfers.get:

  • bigquery.admin
  • bigquery.user

Un usuario al que se le otorgó el permiso bigquery.transfers.get puede enumerar todas las transferencias de un proyecto.

Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta la página de la referencia de control de acceso.

Haz una lista de las transferencias

Sigue los pasos a continuación para hacer una lista de las opciones de configuración de la transferencia en un proyecto:

IU clásica

  1. Ve a la IU web de BigQuery.

    Ir a la IU web de BigQuery

  2. Haz clic en Transferencias. Las opciones de configuración de la transferencia aparecen en la página Transferencias agrupadas por ubicación.

CLI

Para enumerar todas las opciones de la configuración de la transferencia de un proyecto por ubicación, ingresa el comando bq ls y proporciona las marcas --transfer_location y --transfer_config. También puedes proporcionar la marca --project_id para especificar un proyecto en particular. Si no se especifica --project_id, se usa el proyecto predeterminado. La marca --format se puede usar para controlar el formato de salida.

A fin de hacer una lista de opciones de configuración de la transferencia para fuentes de datos particulares, proporciona la marca --filter.

Para ver una cantidad específica de opciones de configuración de la transferencia en un formato de páginas, proporciona la marca --max_results a fin de especificar la cantidad de transferencias. El comando muestra un token de página que proporcionas con la marca --page_token para ver las siguientes n configuraciones.

bq ls \
--transfer_config \
--transfer_location=location \
--project_id=project_id \
--max_results=integer \
--filter=dataSourceIds:data_sources

Donde:

  • location es la ubicación de las opciones de configuración de la transferencia. La ubicación se especifica cuando creas una transferencia.
  • project_id es el ID del proyecto.
  • integer es la cantidad de resultados que se muestran por página.
  • data_sources es una de las siguientes opciones: <<../_shared/_cli-transfer-types.md>>.

Ejemplos:

Ingresa el siguiente comando a fin de mostrar todas las opciones de configuración de la transferencia en EE.UU. de tu proyecto predeterminado. El resultado se controla con la marca --format.

bq ls \
--format=prettyjson \
--transfer_config \
--transfer_location=us

Ingresa el siguiente comando para mostrar todas las configuraciones de transferencia en EE.UU. para el ID del proyecto myproject.

bq ls \
--transfer_config \
--transfer_location=us \
--project_id=myproject

Ingresa el siguiente comando para enumerar las 3 configuraciones de transferencia más recientes.

bq ls \
--transfer_config \
--transfer_location=us \
--project_id=myproject \
--max_results=3

El comando muestra un token de la página siguiente. Copia el token de página y proporciónalo en el comando bq ls para ver los 3 resultados siguientes.

bq ls \
--transfer_config \
--transfer_location=us \
--project_id=myproject \
--max_results=3 \
--page_token=AB1CdEfg_hIJKL

Ingresa el siguiente comando a fin de hacer una lista de las opciones de configuración de la transferencia de Ads y Campaign Manager para el ID del proyecto myproject.

bq ls \
--transfer_config \
--transfer_location=us \
--project_id=myproject \
--filter=dataSourceIds:dcm_dt,adwords

API

Usa el método projects.locations.transferConfigs.list y proporciona el ID del proyecto con el parámetro parent.

Visualiza el historial de ejecución

A medida que se ejecutan las transferencias programadas, se mantiene un historial de ejecución para cada configuración de transferencia que incluye ejecuciones de transferencia correctas y las ejecuciones de transferencia fallidas Las ejecuciones de transferencia con más de 90 días de antigüedad se borran de forma automática del historial de ejecución.

Permisos necesarios

La visualización del historial de ejecución de una configuración de la transferencia requiere permisos bigquery.transfers.get. La función predefinida bigquery.user de Cloud IAM incluye los permisos bigquery.transfers.get.

Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta la página de la referencia de control de acceso.

Visualiza el historial de ejecución

Para ver el historial de ejecución de una configuración de la transferencia, sigue estos pasos:

IU clásica

  1. Ve a la IU web de BigQuery.

    Ir a la IU web de BigQuery

  2. Haz clic en Transferencias.

  3. En la página Transferencias, haz clic en la transferencia apropiada en la lista.

  4. En la página de propiedades, el historial de ejecución aparece debajo de las propiedades de transferencia.

    Historial de ejecución

  5. De manera opcional, desmarca Mostrar solo la última ejecución por día (Show only latest run per day) para ver todas las ejecuciones de transferencia.

El estado de la ejecución de la transferencia se indica de forma gráfica y se detalla en la columna Estado (State):

Ícono Estado
Ícono de ejecución exitosa La ejecución de la transferencia fue exitosa.
Ícono de ejecución con errores La ejecución de la transferencia falló.
Ícono de ejecución con advertencias La ejecución de la transferencia fue exitosa, pero se encontraron advertencias. La ejecución no se considera problemática, a menos que las tablas resultantes parezcan anormales.

CLI

Para enumerar las ejecuciones de transferencia de una configuración de la transferencia en particular, ingresa el comando bq ls y proporciona la marca --transfer_run. También puedes proporcionar la marca --project_id para especificar un proyecto en particular. Si resource_name no contiene información del proyecto, se usa el valor --project_id. Si no se especifica --project_id, se usa el proyecto predeterminado. La marca --format se puede usar para controlar el formato del resultado.

Para ver una cantidad específica de ejecuciones de transferencia, proporciona la marca --max_results. El comando muestra un token de página que proporcionas con la marca --page_token para ver las siguientes n configuraciones.

Para enumerar las ejecuciones de transferencias según el estado de ejecución, ingresa la marca --filter.

bq ls \
--transfer_run \
--max_results=integer \
--transfer_location=location \
--project_id=project_id \
--filter=states:state, ... \
resource_name

Donde:

  • integer es la cantidad de resultados que se mostrarán.
  • location es la ubicación de las opciones de configuración de la transferencia. La ubicación se especifica cuando creas una transferencia.
  • project_id es el ID del proyecto.
  • state, … es una de las siguientes opciones o una lista separada por comas:
    • SUCCEEDED
    • FAILED
    • PENDING
    • RUNNING
    • CANCELLED
  • resource_name es el nombre del recurso de la transferencia (también conocido como la configuración de la transferencia). Si no conoces el nombre del recurso de la transferencia, ejecuta el comando bq ls --transfer_config --transfer_location=location para ver una lista de todas las transferencias.

Ejemplos:

Ingresa el siguiente comando para mostrar las 3 ejecuciones más recientes de la configuración de la transferencia projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7. El resultado se controla con la marca --format.

bq ls \
--format=prettyjson \
--transfer_run \
--max_results=3 \
--transfer_location=us \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

El comando muestra un token de la página siguiente. Copia el token de página y proporciónalo en el comando bq ls para ver los 3 resultados siguientes.

bq ls \
--format=prettyjson \
--transfer_run \
--max_results=3 \
--page_token=AB1CdEfg_hIJKL \
--transfer_location=us \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

Ingresa el siguiente comando para mostrar todas las ejecuciones fallidas de la configuración de la transferencia projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7.

bq ls \
--format=prettyjson \
--transfer_run \
--filter=states:FAILED \
--transfer_location=us \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

Usa el método projects.locations.transferConfigs.list y especifica el ID del proyecto con el parámetro parent.

Visualiza detalles de la ejecución de la transferencia y los mensajes de registro

Cuando aparece una ejecución de la transferencia en el historial de ejecuciones, puedes ver los detalles de la ejecución, incluidos los mensajes de registro, las advertencias y los errores, el nombre de la ejecución, y la hora de inicio y finalización.

Permisos necesarios

La visualización de los detalles de la ejecución de la transferencia requiere permisos bigquery.transfers.get. La función predefinida bigquery.user de Cloud IAM incluye los permisos bigquery.transfers.get.

Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta la página de la referencia de control de acceso.

Visualiza detalles de una ejecución de la transferencia

Para ver los detalles de la ejecución de la transferencia, sigue estos pasos:

IU clásica

  1. Ve a la IU web de BigQuery.

    Ir a la IU web de BigQuery

  2. Haz clic en Transferencias.

  3. En la página Transferencias, haz clic en la transferencia apropiada en la lista.

  4. En la página de propiedades, el historial de ejecución aparece debajo de las propiedades de transferencia. Haz clic en una ejecución para examinar los detalles.

  5. En los detalles de la ejecución, anota el Nombre de la ejecución y cualquier mensaje de error. Esta información es necesaria si te comunicas con el servicio de asistencia de Google Cloud. Los detalles de ejecución también incluyen mensajes de registro y advertencias.

    Detalles del proceso

CLI

Para ver los detalles de la ejecución de la transferencia, ingresa el comando bq show y proporciona el nombre de ejecución de la transferencia con la marca --transfer_run. La marca --format se puede usar para controlar el formato del resultado.

bq show \
--format=prettyjson \
--transfer_run run_name

Donde:

  • run_name es el nombre de ejecución de la transferencia. Puedes recuperar el nombre de la ejecución con el comando bq ls.

Ejemplo:

Ingresa el siguiente comando para mostrar los detalles de la ejecución de la transferencia projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g.

bq show \
--format=prettyjson \
--transfer_run \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g

Para ver los mensajes del registro de transferencias de una ejecución de la transferencia, ingresa el comando bq ls con la marca --transfer_log. Puedes filtrar los mensajes de registro por tipo con la marca --message_type.

Para ver una cantidad específica de mensajes de registro, proporciona la marca --max_results. El comando muestra un token de página que proporcionas con la marca --page_token para ver los próximos n mensajes.

bq ls \
--transfer_log \
--max_results=integer \
--message_type=messageTypes:message_type \
run_name

Donde:

  • integer es la cantidad de mensajes de registro que se mostrarán.
  • message_type es el tipo de mensaje de registro que se debe ver (un solo valor o una lista separada por comas):
    • INFO
    • WARNING
    • ERROR
  • run_name es el nombre de ejecución de la transferencia. Puedes recuperar el nombre de la ejecución con el comando bq ls.

Ejemplos:

Ingresa el siguiente comando para ver los primeros 2 mensajes de registro para la ejecución de la transferencia projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g.

bq ls \
--transfer_log \
--max_results=2 \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g

El comando muestra un token de la página siguiente. Copia el token de la página y proporciónalo en el comando bq ls para ver los 2 resultados siguientes.

bq ls \
--transfer_log \
--max_results=2 \
--page_token=AB1CdEfg_hIJKL \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g

Ingresa el siguiente comando para ver solo los mensajes de error de la ejecución de la transferencia projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g.

bq ls \
--transfer_log \
--message_type=messageTypes:ERROR \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7/runs/1a2b345c-0000-1234-5a67-89de1f12345g

API

Usa el método projects.transferConfigs.runs.transferLogs.list y proporciona el nombre de ejecución de la transferencia con el parámetro parent.

Actualiza una transferencia

Una vez que agregas la transferencia, es posible editarla. Puedes editar cualquiera de los campos propagados durante la creación de la transferencia, excepto la Fuente:

  • Conjunto de datos de destino
  • Nombre visible
  • Cualquiera de los parámetros especificados para el tipo de transferencia específico.
  • Configuración de notificaciones de la ejecución

Permisos necesarios

La actualización de una transferencia requiere permisos bigquery.transfers.update. La función predefinida bigquery.admin de Cloud IAM incluye los permisos bigquery.transfers.update.

Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta la página de la referencia de control de acceso.

Actualiza una transferencia

Para actualizar una transferencia, sigue estos pasos:

IU clásica

  1. Ve a la IU web de BigQuery.

    Ir a la IU web de BigQuery

  2. Haz clic en Transferencias.

  3. En la página Transferencias, haz clic en la transferencia apropiada en la lista.

  4. Haz clic en Editar para actualizar la configuración de transferencia.

  5. Cuando hayas terminado de hacer los cambios, haz clic en Guardar.

CLI

Ingresa el comando bq update, proporciona el nombre del recurso de la configuración de la transferencia con la marca --transfer_config y proporciona las marcas --display_name, --target_dataset, --refresh_window_days o --params.

bq update \
--display_name='name' \
--target_dataset=dataset \
--params='parameters' \
--refresh_window_days=integer \
--transfer_config \
resource_name

Donde:

  • name es el nombre visible de la configuración de la transferencia.
  • dataset es el conjunto de datos de destino para la configuración de la transferencia.
  • parameters contiene los parámetros de la configuración de la transferencia en formato JSON. Por ejemplo: --params='{"param":"param_value"}' Los siguientes parámetros son modificables:
    • Google Ads: customer_id
    • Campaign Manager: bucket y network_id
    • Google Ad Manager: bucket y network_code
    • Google Merchant Center: merchant_id
    • Google Play: bucket y table_suffix
    • Search Ads 360: agency_id, advertiser_id, include_removed_entities, table_filter y custom_floodlight_variables
    • Canal de YouTube: page_id y table_suffix
    • Propietario del contenido de YouTube: content_owner_id y table_suffix
  • integer es un valor de 0 a 30. Para obtener información sobre cómo configurar la ventana de actualización, consulta la documentación de tu tipo de transferencia.
  • resource_name es el nombre del recurso de la transferencia (también conocido como la configuración de la transferencia). Si no conoces el nombre del recurso de la transferencia, ejecuta el comando bq ls --transfer_config --transfer_location=location para ver una lista de todas las transferencias.

Ejemplos:

Ingresa el siguiente comando para actualizar el nombre comercial, el conjunto de datos de destino, la ventana de actualización y los parámetros de la transferencia de Google Ads projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7.

bq update \
--display_name='My changed transfer' \
--target_dataset=mydataset2 \
--params='{"customer_id":"123-123-5678"}' \
--refresh_window_days=3 \
--transfer_config \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

Usa el método projects.transferConfigs.patch y proporciona el nombre del recurso de la transferencia con el parámetro transferConfig.name. Si no conoces el nombre del recurso de la transferencia, ejecuta el comando bq ls --transfer_config --transfer_location=location para ver una lista de todas las transferencias o llama al método projects.locations.transferConfigs.list y proporciona el ID del proyecto con el parámetro parent.

Configuración de reabastecimientos y ejecuciones de actualización

Actualización

Ten en cuenta que los reabastecimientos no están disponibles para estos tipos de transferencias. Sin embargo, puedes configurar una ejecución de actualización.

Reabastecimiento

Puedes iniciar de forma manual un reabastecimiento de datos en cualquier momento. Además de los límites de fuente, el Servicio de transferencia de datos de BigQuery admite un máximo de 180 días por solicitud de reabastecimiento. No se admiten solicitudes de reabastecimiento simultáneas.

Cuando reabasteces períodos grandes, divide tus solicitudes de reabastecimiento en partes de 180 días y espera a que finalice la solicitud de reabastecimiento anterior antes de crear otra.

Para obtener más información sobre la cantidad de datos disponibles para el reabastecimiento, consulta la documentación de tu fuente de datos:

  • Campaign Manager
  • Google Ad Manager
  • Google Ads
    • Cuando configuras un reabastecimiento para Google Ads, las instantáneas de las tablas de coincidencia se toman una vez al día y se almacenan en la partición para la última fecha de ejecución. Cuando programas un reabastecimiento, las instantáneas de la tabla de coincidencia para las siguientes tablas NO se actualizan:
      • Ad
      • AdGroup
      • AgeRange
      • Audience
      • BidGoal
      • Budget
      • Campaign
      • Criteria
      • Customer
      • Gender
      • Keyword
      • LocationBasedCampaignCriterion
      • ParentalStatus
      • Placement
      • Video
  • Google Merchant Center (Beta)
  • Google Play (Beta)
  • Search Ads 360
    • Cuando configuras un reabastecimiento para Search Ads 360, las instantáneas de las tablas de coincidencia se toman una vez al día y se almacenan en la partición para la última fecha de ejecución. Cuando programas un reabastecimiento, las instantáneas de la tabla de coincidencia para las siguientes tablas NO se actualizan:
      • Account
      • Ad
      • Advertiser
      • AdGroup
      • AdGroupTarget
      • BidStrategy
      • Campaign
      • CampaignTarget
      • FeedItem
      • FloodlightActivity
      • Keyword
      • NegativeAdGroupKeyword
      • NegativeAdGroupTarget
      • NegativeCampaignKeyword
      • NegativeCampaignTarget
      • ProductAdvertised
      • ProductGroup
      • ProductLeadAndCrossSellFloodlightStats
      • Video
      • Placement
      • Video
  • YouTube: Informes de canales
  • YouTube: Informes del propietario de contenido

Ten en cuenta que los reabastecimientos no están disponibles para transferencias de Cloud Storage (Beta). Sin embargo, puedes configurar una ejecución de actualización de una transferencia de Cloud Storage.

Permisos necesarios

Programar un reabastecimiento requiere permisos bigquery.transfers.update. La función predefinida bigquery.admin de Cloud IAM incluye los permisos bigquery.transfers.update.

Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta la página de la referencia de control de acceso.

Programa un reabastecimiento

Sigue los pasos a continuación para programar un reabastecimiento:

IU clásica

  1. Ve a la IU web de BigQuery. Ir a la IU web de BigQuery
  2. Haz clic en Transferencias.
  3. En la página de Transferencia, haz clic en la transferencia apropiada.
  4. Haz clic en Programar reabastecimiento (Schedule Backfill).

    Programar el reabastecimiento

  5. En el cuadro de diálogo Programar ejecución (Schedule Run), haz lo siguiente:

    • Para la Fecha de inicio de datos (Data Start Date), ingresa o elige la fecha apropiada en formato MM/DD/AAAA.
    • Para la Fecha de finalización de datos (Data End Date), ingresa o elige la fecha apropiada en formato MM/DD/AAAA.
    • Haz clic en Aceptar (OK).

    Programar el reabastecimiento

CLI

Ingresa el comando bq mk, ingresa la marca --transfer_run y específica los valores --start_time y --end_time.

bq mk \
--transfer_run \
--start_time='start_time' \
--end_time='end_time' \
resource_name

Donde:

  • start_time y end_time son marcas de tiempo que terminan en Z o contienen un desplazamiento de zona horaria válido. Por ejemplo:

    • 2017-08-19T12:11:35.00Z
    • 2017-05-25T00:00:00+00:00
  • resource_name es el nombre del recurso de la transferencia (también conocido como la configuración de la transferencia). Si no conoces el nombre del recurso de la transferencia, ejecuta el comando bq ls --transfer_config --transfer_location=location para ver una lista de todas las transferencias.

Ejemplos:

Ingresa el siguiente comando a fin de programar un reabastecimiento para la configuración de la transferencia projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7.

bq mk \
--transfer_run \
--start_time 2017-05-25T00:00:00Z \
--end_time 2017-05-25T00:00:00Z \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

Usa el método projects.locations.transferConfigs.scheduleRuns y proporciona el recurso de configuración de la transferencia mediante el parámetro parent.

Actualiza las credenciales

Una transferencia usa las credenciales del usuario que la creó. Si necesitas cambiar el usuario adjunto a una configuración de transferencia, puedes actualizar las credenciales de la transferencia. Esto es útil si el usuario que creó la transferencia ya no está en tu organización.

Permisos necesarios

La actualización de credenciales requiere los permisos bigquery.transfers.update. La función predefinida bigquery.admin de Cloud IAM incluye los permisos bigquery.transfers.update.

Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta la página de la referencia de control de acceso.

Actualiza las credenciales de una transferencia

Para actualizar las credenciales de una transferencia, haz lo siguiente:

IU clásica

  1. Ve a la IU web de BigQuery. Ir a la IU web de BigQuery
  2. Haz clic en Transferencias.
  3. En la página de Transferencia, haz clic en la transferencia apropiada.
  4. Haz clic en Actualizar credenciales.
  5. Haz clic en Aceptar cuando se te solicite.
  6. Ingresa a tu Cuenta de Google y haz clic en Permitir a fin de otorgar permiso al Servicio de Transferencia de BigQuery para ver los datos de informes, además de acceder y administrar los datos en BigQuery. Debes permitir que las ventanas emergentes de bigquery.cloud.google.com vean la ventana de permisos.

CLI

Ingresa el comando bq update, proporciona el nombre del recurso de la configuración de la transferencia con la marca --transfer_config y, también, ingresa la marca --update_credentials.

bq update \
--update_credentials=boolean \
--transfer_config \
resource_name

Donde:

  • boolean es un valor booleano que indica si las credenciales deben actualizarse para la configuración de la transferencia.
  • resource_name es el nombre del recurso de la transferencia (también conocido como la configuración de la transferencia). Si no conoces el nombre del recurso de la transferencia, ejecuta el comando bq ls --transfer_config --transfer_location=location para ver una lista de todas las transferencias.

Ejemplos:

Ingresa el siguiente comando a fin de actualizar las credenciales para la transferencia de Google Ads projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7.

bq update \
--update_credentials=true \
--transfer_config \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

Usa el método projects.transferConfigs.patch y proporciona los parámetros authorizationCode y updateMask.

Inhabilita una transferencia

Cuando inhabilitas una transferencia, se agrega inhabilitado al nombre de la transferencia. Cuando la transferencia está inhabilitada, no se programan ejecuciones de transferencia nuevas ni se permiten reabastecimientos nuevos. Se completan todas las transferencias en ejecución.

Inhabilitar una transferencia no quita ningún dato que ya se transfirió a BigQuery. Los datos transferidos con anterioridad generan costos de almacenamiento de BigQuery estándar hasta que borres el conjunto de datos o borres las tablas.

Permisos necesarios

Para inhabilitar una transferencia, se necesitan permisos bigquery.transfers.update. La función predefinida bigquery.admin de Cloud IAM incluye los permisos bigquery.transfers.update.

Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta la página de la referencia de control de acceso.

Inhabilita una transferencia

Para inhabilitar una transferencia, sigue estos pasos:

IU clásica

  1. Ve a la IU web clásica de BigQuery.

    Ir a la IU web clásica de BigQuery

  2. Haz clic en Transferencias.

  3. Haz clic en la transferencia que estás inhabilitando.

  4. En la página de propiedades de transferencia, haz clic en Inhabilitado (Disabled).

    Inhabilitar la transferencia

  5. Después de inhabilitar la transferencia, haz clic en Guardar.

CLI

Inhabilitar una transferencia no es compatible con la CLI.

API

Usa el método projects.locations.transferConfigs.patch y establece disabled en true en el recurso projects.locations.transferConfig.

Borra una transferencia

Cuando borras una transferencia, no se programan ejecuciones de transferencia nuevas. Cualquier transferencia en ejecución se detiene.

Borrar una transferencia no quita ningún dato ya transferido a BigQuery. Los datos transferidos con anterioridad generan costos de almacenamiento de BigQuery estándar hasta que borres el conjunto de datos o borres las tablas.

Permisos necesarios

Para borrar una transferencia, se necesitan los permisos bigquery.transfers.update. La función predefinida bigquery.admin de Cloud IAM incluye los permisos bigquery.transfers.update.

Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta la página de la referencia de control de acceso.

Borra una transferencia

Sigue los pasos a continuación para borrar una transferencia:

IU clásica

  1. Ve a la IU web de BigQuery.

    Ir a la IU web clásica de BigQuery

  2. Haz clic en Transferencias.

  3. Haz clic en la transferencia que estás editando.

  4. En la página de propiedades de transferencia, haz clic en Borrar.

  5. Cuando se te solicite, haz clic en Aceptar para quitar la transferencia.

CLI

Ingresa el comando bq rm y proporciona el nombre del recurso de la configuración de la transferencia. Puedes usar la marca -f para borrar una configuración de la transferencia sin confirmación.

bq rm \
-f \
--transfer_config \
resource_name

Donde:

  • resource_name es el nombre del recurso de la transferencia que también se denomina configuración de la transferencia. Si no conoces el nombre del recurso de la transferencia, ejecuta el comando bq ls --transfer_config --transfer_location=location para ver una lista de todas las transferencias.

Por ejemplo, ingresa el siguiente comando para borrar la configuración de la transferencia projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7.

bq rm \
--transfer_config \
projects/myproject/locations/us/transferConfigs/1234a123-1234-1a23-1be9-12ab3c456de7

API

Usa el método projects.locations.transferConfigs.delete y proporciona el recurso que estás borrando con el parámetro name.