Crea y administra espacios de trabajo

Vista previa

Este producto o función está sujeto a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Nota: Para enviar comentarios o hacer preguntas relacionadas con esta función de versión preliminar, comunícate con [e-mail].

Cuando usas repositorios de BigQuery para control de versión de tus archivos, usas espacios de trabajo para editar el código dentro de esos repositorios. En este documento, se muestra cómo crear, borrar y administrar archivos en un espacio de trabajo.

Para obtener una experiencia de control de versión basada en carpetas, te recomendamos que uses los repositorios de Git de BigQuery Studio. Esta integración te permite trabajar con ramas de Git directamente en el explorador de archivos de BigQuery Studio y clonar varios repositorios a la vez sin administrar espacios de trabajo independientes.

Antes de comenzar

Si aún no lo hiciste, crea un repositorio de BigQuery.

Roles obligatorios

El acceso a los espacios de trabajo se determina según los roles otorgados en su repositorio superior. Para obtener más información, consulta las Funciones requeridas.

Crea un lugar de trabajo

La creación de espacios de trabajo se controla de manera diferente según si usas un repositorio de BigQuery o un repositorio de terceros.

Crea un espacio de trabajo en un repositorio de BigQuery

Para crear un espacio de trabajo nuevo en un repositorio de BigQuery, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio en el que quieres crear un espacio de trabajo.

4. En el editor, haz clic en Agregar espacio de trabajo.

5. En el panel Crear espacio de trabajo de desarrollo, en el campo ID del espacio de trabajo, ingresa un ID único para el espacio de trabajo.

   Los IDs solo pueden incluir números, letras, guiones y guiones bajos.

6. Haz clic en Crear.

Crea un espacio de trabajo en un repositorio de terceros

Para crear un espacio de trabajo nuevo en un repositorio de terceros, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio en el que quieres crear un espacio de trabajo.

4. En el editor, haz clic en Agregar espacio de trabajo. Se abrirá el panel Crear espacio de trabajo de desarrollo.

5. Elige el botón de selección Rama remota existente o Rama nueva, según si deseas usar una rama existente o nueva para el espacio de trabajo.

6. Especifica la rama que se usará:

   1. Si elegiste el botón de selección Rama remota existente, elige una rama existente en el campo Rama remota.

   2. Si elegiste el botón de selección Rama nueva, escribe un nombre de rama en el campo ID del espacio de trabajo. El nombre de la rama que se creó en el repositorio de terceros es el mismo que el ID del espacio de trabajo de BigQuery.

      Los IDs solo pueden incluir números, letras, guiones y guiones bajos.

7. Haz clic en Crear.

Crea un directorio en un espacio de trabajo

Para crear un directorio en un espacio de trabajo, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo con el que quieres trabajar.

4. Busca el espacio de trabajo y, luego, haz clic en Abrir.

   Se abrirá el espacio de trabajo en el panel Control de código fuente de .

5. Haz clic en Abrir menú de creación.

6. Haz clic en Crear en el repositorio > Directorio.

7. En el campo Agregar una ruta de acceso al directorio, escribe una ruta de acceso al directorio.

8. Haz clic en Crear directorio.

Cómo trabajar con archivos en un espacio de trabajo

Puedes crear archivos nuevos en un espacio de trabajo o subir archivos existentes.

Puedes crear o subir los siguientes tipos de archivos a un repositorio:

• Consultas en SQL
• Notebooks de Python
• Lienzos de datos
• Preparación de datos
• Archivos de cualquier otro tipo

Crear un archivo

Para crear un archivo en un espacio de trabajo, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo con el que quieres trabajar.

4. Busca el espacio de trabajo y, luego, haz clic en Abrir.

   Se abrirá el espacio de trabajo en el panel Control de código fuente de .

5. Haz clic en Abrir menú de creación.

6. Haz clic en Crear en el repositorio y, luego, en el tipo de archivo que deseas crear.

7. En el campo Nombre, escribe un nombre de archivo.

8. Opcional: En el campo Directorio superior, escribe la ruta de acceso del directorio en el que deseas crear el archivo.

9. Haz clic en Guardar.

Subir un archivo

Para subir un archivo a un espacio de trabajo, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo con el que quieres trabajar.

4. Busca el espacio de trabajo y, luego, haz clic en Abrir.

   Se abrirá el espacio de trabajo en el panel Control de código fuente de .

5. Haz clic en Abrir menú de creación.

6. Haz clic en Subir al repositorio y, luego, en el tipo de archivo que quieres subir.

7. En el panel de carga, realiza una de las siguientes acciones:

   • En el campo Subir archivo, haz clic en Explorar, selecciona un archivo y, luego, haz clic en Abrir.
   • En el campo URL, escribe la URL del archivo.

8. Opcional: En el campo directorio superior, escribe la ruta de acceso del directorio en el que deseas crear el archivo.

9. Haz clic en Subir.

Cómo borrar un archivo

Para borrar un archivo de un espacio de trabajo, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo con el que quieres trabajar.

4. Busca el espacio de trabajo y, luego, haz clic en Abrir.

   Se abrirá el espacio de trabajo en el panel Control de código fuente de .

5. Selecciona el archivo que deseas borrar, haz clic en Ver acciones y, luego, en Borrar.

6. Haz clic en Borrar para confirmar tu decisión.

Usa el control de versión con un archivo

En esta sección, se muestra cómo usar el control de versión en BigQuery para hacer un seguimiento de los archivos en los espacios de trabajo.

BigQuery usa Git para realizar un seguimiento de cada cambio realizado en los archivos dentro de un repositorio. En un repositorio de BigQuery, interactúas directamente con el repositorio de Git. En un repositorio conectado, interactúas con la rama predeterminada del repositorio remoto que configuraste cuando conectaste el repositorio.

BigQuery muestra opciones de control de versión según el estado de los cambios en tu espacio de trabajo. Por ejemplo, BigQuery muestra la opción de confirmación solo cuando hay cambios locales sin confirmar en tu espacio de trabajo. Cuando los archivos de tu espacio de trabajo son una copia exacta de tu rama predeterminada, BigQuery muestra el estado Actualizado.

BigQuery muestra las siguientes opciones de control de versión:

Confirmar X cambio(s)

Confirma la cantidad X de cambios locales en tu espacio de trabajo o los archivos modificados seleccionados. BigQuery muestra los cambios no confirmados.

Enviar a la rama predeterminada

Envía los cambios confirmados a la rama predeterminada. Esta opción está disponible en un repositorio si no tienes cambios sin confirmar en tu espacio de trabajo y hay confirmaciones sin enviar.

Enviar a your-branch-name

Envía los cambios confirmados a your-branch-name. Esta opción está disponible en un repositorio conectado a un repositorio de Git de terceros si no tienes cambios sin confirmar en tu espacio de trabajo. El nombre de la rama remota en el repositorio de terceros es el mismo que el ID del espacio de trabajo de BigQuery.

Extraer de la rama predeterminada

Actualiza tus espacios de trabajo con los cambios recientes de tu rama predeterminada. Esta opción está disponible en un repositorio si no tienes cambios sin confirmar en tu espacio de trabajo.

Extraer de your-branch-name

Actualiza tu espacio de trabajo con los cambios recientes de your-branch-name. Esta opción está disponible en un repositorio conectado a un repositorio de Git de terceros si no tienes cambios sin confirmar en tu espacio de trabajo. El nombre de la rama remota en el repositorio de terceros es el mismo que el ID del espacio de trabajo de BigQuery.

Volver a la última confirmación

Restablece los archivos de tu espacio de trabajo al estado de tu última confirmación.

Extraer cambios

Si tu espacio de trabajo no está sincronizado con tu repositorio, BigQuery muestra la opción Extraer.

Para extraer los cambios de tu repositorio a tu espacio de trabajo, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo con el que quieres trabajar.

4. Busca el espacio de trabajo y, luego, haz clic en Abrir.

   Se abrirá el espacio de trabajo en el panel Control de código fuente de .

5. En el panel del espacio de trabajo, haz lo siguiente:

   1. Si estás en un repositorio de BigQuery, haz clic en Extraer de la rama predeterminada.

   2. Si estás en un repositorio conectado a un repositorio de Git de terceros, realiza una de las siguientes acciones:

      1. Haz clic en Extraer de la rama predeterminada para extraer de la rama predeterminada del repositorio de terceros.
      2. Haz clic en Extraer de your-branch-name para extraer de la rama del repositorio de terceros que corresponde al espacio de trabajo actual.

Confirmar cambios

Después de realizar un cambio en un espacio de trabajo, BigQuery muestra la opción Confirmar. Puedes confirmar todos los cambios locales o los archivos seleccionados. Los archivos que agregaste o modificaste se identifican con un punto azul junto a ellos en el panel del espacio de trabajo.

Nota: De forma predeterminada, BigQuery usa la dirección de correo electrónico del usuario autenticado Google Cloud para el autor de la confirmación, pero la API de Dataform permite establecer una dirección de correo electrónico personalizada para el autor de la confirmación. Este comportamiento es similar al del comando git commit --author y solo afecta al historial de confirmaciones de Git. La identidad del autor de la confirmación no se verifica de forma criptográfica.

Para confirmar los cambios de tu espacio de trabajo en tu repositorio, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo con el que quieres trabajar.

4. Busca el espacio de trabajo y, luego, haz clic en Abrir.

   Se abrirá el espacio de trabajo en el panel Control de código fuente de .

5. En el panel del espacio de trabajo, haz clic en Confirmar X cambios.

6. En el panel Confirmar cambios, haz lo siguiente:

   1. Selecciona los archivos modificados que deseas confirmar.

      Si no seleccionas ningún archivo, BigQuery confirma todos los cambios locales. Puedes filtrar los archivos modificados por estado, nombre y ruta de acceso.

   2. En el campo Agrega un mensaje de confirmación, escribe una descripción para tu confirmación.

   3. Haz clic en Confirmar todos los cambios o Confirmar X cambios.

      El nombre del botón depende de la selección de archivos que confirmes.

Envía los cambios

BigQuery muestra la opción Enviar después de confirmar los cambios.

Para enviar los cambios de tu espacio de trabajo a tu repositorio, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo con el que quieres trabajar.

4. Busca el espacio de trabajo y, luego, haz clic en Abrir.

   Se abrirá el espacio de trabajo en el panel Control de código fuente de .

5. En el panel del espacio de trabajo, haz lo siguiente:

   1. Si estás en un repositorio de BigQuery, haz clic en Enviar a la rama predeterminada.

   2. Si estás en un repositorio conectado a un repositorio de Git de terceros, realiza una de las siguientes acciones:

      1. Haz clic en Enviar a la rama predeterminada para enviar a la rama predeterminada del repositorio de terceros.
      2. Haz clic en Enviar a your-branch-name para enviar a la rama del repositorio de terceros que corresponde al espacio de trabajo actual.

Revertir los cambios no confirmados

Para revertir los cambios no confirmados, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo con el que quieres trabajar.

4. Busca el espacio de trabajo y, luego, haz clic en Abrir.

   Se abrirá el espacio de trabajo en el panel Control de código fuente de .

5. En el panel del espacio de trabajo, haz clic en la flecha desplegable del botón de control de versión y, luego, en Revertir a la última confirmación.

Cómo resolver conflictos de fusión

Un conflicto de combinación puede ocurrir cuando un cambio local en tu espacio de trabajo es incompatible con un cambio que se realizó en la rama predeterminada de tu repositorio. Los conflictos de combinación suelen ocurrir cuando varios usuarios editan el mismo archivo de forma simultánea.

Por lo general, se produce un conflicto de combinación cuando extraes de una rama después de que otro usuario envió un cambio conflictivo a la misma rama. Debes resolver un conflicto de combinación de forma manual editando el archivo afectado.

En la siguiente muestra de código, se observa un conflicto de combinación que se muestra en un archivo SQL:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

Para resolver un conflicto de combinación, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo con el que quieres trabajar.

4. Busca el espacio de trabajo y, luego, haz clic en Abrir.

   Se abrirá el espacio de trabajo en el panel Control de código fuente de .

5. Selecciona el archivo afectado y edítalo con los cambios que elijas.

6. Confirma los cambios.

7. Opcional: Envía los cambios.

Ver historial de confirmaciones

Para ver el historial de confirmaciones, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo con el que quieres trabajar.

4. Busca el espacio de trabajo y, luego, haz clic en Abrir.

   Se abrirá el espacio de trabajo en el panel Control de código fuente de .

5. En el panel del espacio de trabajo, haz clic en el menú desplegable de flecha en el botón de control de versión y, luego, en Ver historial de confirmaciones.

Borra un espacio de trabajo

Para borrar un espacio de trabajo y todo su contenido, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Control de código fuente.

   

   Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

3. Selecciona el repositorio que contiene el espacio de trabajo que deseas borrar.

4. Busca tu espacio de trabajo y, luego, haz clic en Abrir acciones > Borrar.

5. Haz clic en Borrar.

¿Qué sigue?

• Aprende a administrar código con repositorios de Git de BigQuery Studio.
• Obtén más información para crear repositorios.