Borra modelos

En esta página, se muestra cómo borrar los modelos de BigQuery ML. Para borrar un modelo, haz lo siguiente:

  • Usa GCP Console.
  • Usa el comando bq rm de la herramienta de línea de comandos o el comando bq query.
  • Llama al método de la API models.delete o al método jobs.query.
  • Usa las bibliotecas cliente.

Actualmente, solo puedes borrar un modelo a la vez. Cuando borras un modelo, también se borran todos los datos en el modelo.

Para borrar automáticamente los modelos después de un período específico, configura su hora de vencimiento cuando lo crees mediante la CLI, la API, o las bibliotecas cliente. Si no configuraste el vencimiento cuando creaste el modelo, puedes actualizarlo.

Limitaciones en la eliminación de modelos

Borrar un modelo está sujeto a las siguientes limitaciones:

  • No puedes borrar varios modelos al mismo tiempo. Los modelos se deben borrar individualmente.
  • La acción de borrar un modelo no se puede deshacer.

Permisos necesarios

Para borrar los modelos en un conjunto de datos, debes tener asignada la función WRITER en el conjunto de datos, o una función de IAM a nivel del proyecto que incluya permisos bigquery.models.delete. Si tienes permisos bigquery.models.delete a nivel del proyecto, puedes borrar modelos de cualquier conjunto de datos en el proyecto. Las siguientes funciones de IAM a nivel del proyecto incluyen los permisos bigquery.models.delete:

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

Para obtener más información sobre las funciones de IAM y los permisos en BigQuery ML, consulta Control de acceso. Si deseas obtener más información sobre las funciones a nivel del conjunto de datos, consulta Funciones básicas para conjuntos de datos en la documentación de BigQuery.

Borra un modelo

Para borrar un modelo, haz lo siguiente:

Console

Puedes borrar un modelo en la IU web de BigQuery mediante la opción Borrar modelo o mediante la ejecución de una consulta que contenga una declaración DDL DROP MODEL | DROP MODEL IF EXISTS.

Opción uno: Usa la opción Borrar modelo.

  1. Ve a la IU web de BigQuery en GCP Console.

    Ir a la IU web de BigQuery

  2. En el panel de navegación, en la sección Recursos, expande el nombre de tu proyecto y del conjunto de datos.

  3. Haz clic en el nombre de tu modelo. Los modelos se indican con el ícono de modelo: ícono del modelo.

  4. En el lado derecho de la ventana, haz clic en Borrar modelo.

  5. En el diálogo Borrar modelo, escribe el nombre del modelo y luego haz clic en Borrar.

Opción dos: Usa una declaración DDL.

  1. Ve a la IU web de BigQuery.

    Ir a la IU web de BigQuery

  2. Haz clic en Redactar consulta.

  3. Escribe tu declaración DDL en el área de texto Consulta nueva.

     DROP MODEL mydataset.mymodel
     

  4. Haz clic en Ejecutar consulta. Cuando se completa la consulta, se quita el modelo del panel de navegación.

CLI

Puedes borrar un modelo con la herramienta de línea de comandos bq si ingresas:

  • el comando bq rm con la marca --model o -m
  • el comando bq query y proporcionas la declaración DDL como el parámetro de consulta

Si borras un modelo en otro proyecto que no sea el predeterminado, agrega el ID del proyecto al conjunto de datos en el siguiente formato: [PROJECT_ID]:[DATASET].[MODEL].

Opción uno: Ingresa el comando bq rm

Cuando usas el comando bq rm para quitar un modelo, debes confirmar la acción. Puedes usar la marca --force (o el acceso directo -f) para omitir la confirmación.

bq rm -f --model [PROJECT_ID]:[DATASET].[MODEL]

Aquí:

  • [PROJECT_ID] es el ID del proyecto.
  • [DATASET] es el nombre del conjunto de datos.
  • [MODEL] es el nombre del modelo que estás borrando.

El comando rm no produce ningún resultado.

Ejemplos:

Ingresa el siguiente comando para borrar mymodel de mydataset. mydataset se encuentra en tu proyecto predeterminado.

bq rm --model mydataset.mymodel

Ingresa el siguiente comando para borrar mymodel de mydataset. mydataset se encuentra en myotherproject, no en tu proyecto predeterminado.

bq rm --model myotherproject:mydataset.mymodel

Ingresa el siguiente comando para borrar mymodel de mydataset. mydataset se encuentra en tu proyecto predeterminado. El comando usa el acceso directo -f para omitir la confirmación.

bq rm -f --model mydataset.mymodel

Para confirmar que se borró el modelo, ejecuta el comando bq ls. Si deseas obtener más información, consulta Mostrar una lista de modelos.

Opción dos: Ingresa el comando bq query

Para borrar un modelo mediante el comando bq query, proporciona la declaración DROP MODEL en el parámetro de consulta y proporciona la marca --use_legacy_sql=false a fin de especificar la sintaxis de consulta de SQL estándar.

Ejemplos:

Ingresa el siguiente comando para borrar mymodel de mydataset. mydataset se encuentra en tu proyecto predeterminado.

bq query --use_legacy_sql=false 'DROP MODEL mydataset.mymodel'

Ingresa el siguiente comando para borrar mymodel de mydataset. mydataset se encuentra en myotherproject, no en tu proyecto predeterminado.

bq query --use_legacy_sql=false \
'DROP MODEL myotherproject:mydataset.mymodel'

API

Opción uno: Llama al método models.delete

Para borrar un modelo, llama al método models.delete y proporciona el projectId, datasetId y modelId.

Opción dos: Llama al método jobs.query

Para borrar un modelo, llama al método jobs.query y proporciona la declaración DDL DROP MODEL en la propiedad de consulta del cuerpo de la solicitud.

Cómo restablecer un modelo borrado

Actualmente, no puedes restablecer un modelo borrado.

Qué sigue

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de BigQuery ML