Crear y gestionar carpetas

Vista previa

Esta función está sujeta a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Nota: Para enviar comentarios o solicitar asistencia sobre esta función, escribe un correo a [e-mail].

En el siguiente documento se describe cómo crear y gestionar carpetas en BigQuery. Puedes usar carpetas para organizar y controlar el acceso a recursos de código de un solo archivo, como cuadernos, consultas guardadas, lienzos de datos y archivos de preparación de datos. BigQuery ofrece carpetas de usuario para que los usuarios gestionen sus propios recursos de código y carpetas de equipo para gestionar los recursos de código de un equipo.

Las carpetas de BigQuery se basan en Dataform.

Antes de crear carpetas, consulta cómo funcionan las carpetas de BigQuery en el artículo Organizar recursos de código con carpetas.

Antes de empezar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Roles obligatorios

Para obtener los permisos que necesitas para completar las tareas de este documento, pide a tu administrador que te conceda los roles de gestión de identidades y accesos adecuados en el proyecto, la carpeta o el recurso.

Para obtener los permisos que necesitas para usar el explorador de archivos de BigQuery, pide a tu administrador que te conceda el rol Usuario de BigQuery (roles/bigquery.user) o Usuario de BigQuery Studio (roles/bigquery.studioUser) en el proyecto.

Los permisos concedidos en una carpeta se propagan a todos los archivos y carpetas que contiene.

Se aplican las siguientes condiciones a los archivos y a las carpetas que los contienen:

Rol	Concedido el	Permisos y casos prácticos
Propietario del código (roles/dataform.codeOwner)	Archivo o carpeta	Concede control total sobre un recurso en el sistema de archivos y carpetas. Un usuario con este rol puede realizar todas las acciones, como eliminar el recurso, definir su política de gestión de identidades y accesos y moverlo.
Editor de código (roles/dataform.codeEditor)	Archivo o carpeta	Permite editar y gestionar contenido. Un usuario con este rol puede añadir contenido a las carpetas, editar archivos y obtener la política de gestión de identidades y accesos de un archivo o una carpeta. Este rol también es obligatorio en la carpeta de destino al mover un recurso.
Comentador de código (roles/dataform.codeCommenter)	Archivo o carpeta	Permite comentar recursos de código o carpetas.
Visor de código (roles/dataform.codeViewer)	Archivo o carpeta	Proporciona acceso de solo lectura. Un usuario con este rol puede consultar el contenido de archivos y carpetas.
Creador de código (roles/dataform.codeCreator)	Proyecto	Concede permiso para crear archivos y carpetas en un proyecto.

Los siguientes roles son específicos para gestionar carpetas de equipo:

Rol	Concedido el	Permisos y casos prácticos
Propietario de la carpeta de equipo (roles/dataform.teamFolderOwner)	Carpeta de equipo	Concede control total sobre una carpeta de equipo en el sistema de archivos y carpetas. Un usuario con este rol puede eliminar la carpeta de equipo y definir su política de gestión de identidades y accesos.
Colaborador de carpeta de equipo (roles/dataform.teamFolderContributor)	Carpeta de equipo	Permite gestionar el contenido de una carpeta de equipo. Un usuario con este rol puede actualizar una carpeta de equipo.
Comentador de carpetas de equipo (roles/dataform.teamFolderCommenter)	Carpeta de equipo	Permite comentar una carpeta de equipo y los recursos de código que contiene.
Visor de carpetas de equipo (roles/dataform.teamFolderViewer)	Carpeta de equipo	Proporciona acceso de solo lectura a una carpeta de equipo y a su contenido. Un usuario con este rol puede ver una carpeta de equipo y obtener su política de gestión de identidades y accesos.
Creador de carpetas de equipo (roles/dataform.teamFolderCreator)	Proyecto	Concede permiso para crear carpetas de equipo en un proyecto.

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para completar las tareas de este documento. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

• Crear una carpeta:
  • folders.create en la carpeta de usuario principal, la carpeta de equipo o el proyecto
  • folders.addContents en la carpeta principal o en la carpeta de equipo
• Recuperar las propiedades de una carpeta: folders.get en la carpeta
• Consultar el contenido de una carpeta o una carpeta de equipo: folders.queryContents en la carpeta
• Actualizar una carpeta: folders.update en la carpeta
• Eliminar una carpeta: folders.delete en la carpeta
• Obtener la política de gestión de identidades y accesos de una carpeta: folders.getIamPolicy en la carpeta
• Define la política de gestión de identidades y accesos de una carpeta: folders.setIamPolicy en la carpeta
• Mover una carpeta:
  • folders.move en la carpeta que se va a mover
  • folders.addContents en la carpeta de destino o en la carpeta de equipo (no es necesario si se mueve a una carpeta raíz)
• Crea una carpeta de equipo: teamFolders.create en el proyecto
• Eliminar una carpeta de equipo: teamFolders.delete en la carpeta de equipo
• Obtener la política de gestión de identidades y accesos de una carpeta de equipo: teamFolders.getIamPolicy en la carpeta de equipo
• Definir la política de gestión de identidades y accesos de una carpeta de equipo: teamFolders.setIamPolicy en la carpeta de equipo
• Obtener las propiedades de una carpeta de equipo: teamFolders.get en la carpeta de equipo
• Actualizar una carpeta de equipo: teamFolders.update en la carpeta de equipo

También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.

Para obtener acceso completo a todas las carpetas y archivos de tu proyecto, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto:

• Administrador de Dataform (roles/dataform.admin)
• Editor de Dataform (roles/dataform.editor)
• Lector de Dataform (roles/dataform.viewer)

Ver recursos

Sigue estos pasos para ver carpetas y recursos de código en BigQuery:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

   Si no ves el panel de la izquierda, haz clic en Ampliar panel de la izquierda para abrirlo.

3. Haz una de las siguientes acciones para ver las carpetas y los recursos de código del proyecto y la región de código seleccionados:

   • Expande el nodo Usuario (tu dirección de correo) para ver las carpetas y los archivos que has creado.
   • Despliega el nodo Carpetas de equipo para ver todas las carpetas de equipo a las que tienes acceso.
   • Despliega el nodo Compartido conmigo para ver todas las carpetas y los archivos que otros usuarios han compartido contigo.

Cambiar la región del código

Puedes tener carpetas y recursos de código en diferentes regiones de código. Sigue estos pasos para cambiar la región de código que estás viendo:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

3. Junto al nombre del proyecto, haz clic en Ver acciones del panel de archivos > Cambiar región de código.

4. Selecciona la región de código que quieras ver.

5. Haz clic en Guardar.

Crear una carpeta o un recurso de código

Sigue este procedimiento para crear cualquiera de los siguientes recursos:

• Una carpeta de usuario o un recurso de código en cualquier nivel.
• Una subcarpeta de una carpeta de equipo.
• Un recurso de código en la subcarpeta de una carpeta de equipo.

Para obtener información sobre cómo crear una carpeta de equipo, consulta el artículo Crear una carpeta de equipo.

Sigue estos pasos para crear una carpeta o un recurso de código en BigQuery:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

3. Selecciona el nodo raíz del usuario o la carpeta en la que quieras crear el recurso.

4. Haz clic en Ver acciones > Crear y, a continuación, selecciona el tipo de recurso que quieras crear.

5. En el panel de creación de recursos, escribe un nombre para el nuevo recurso.

6. Haz clic en Guardar.

Crear una carpeta de equipo

Sigue estos pasos para crear una carpeta de equipo en BigQuery:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

3. Selecciona el nodo raíz de la carpeta de equipo.

4. Haz clic en Ver acciones > Crear carpeta de equipo.

5. En el cuadro de diálogo Crear carpeta de equipo, escribe un nombre para la carpeta de equipo.

6. Haz clic en Crear.

Subir un recurso de código

Sigue estos pasos para subir un recurso de código en BigQuery:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

3. Selecciona la carpeta en la que quieras subir el recurso de código.

4. Haz clic en Ver acciones > Subir y, a continuación, selecciona el tipo de recurso de código que quieras subir.

5. En el panel de recursos de subida, haga una de las siguientes acciones:

   • Haz clic en el botón de radio Subida de archivo y, a continuación, busca y selecciona un archivo local.
   • Haz clic en el botón de radio URL y, a continuación, escribe la URL de un archivo de recurso de código que se encuentre en un repositorio de GitHub.

6. Escribe un nombre para el recurso de código.

7. Opcional: Selecciona una región en la que almacenar el recurso de código. Si seleccionas una región distinta del valor predeterminado, esa región se convertirá en la región predeterminada en la que se crearán todos los recursos de código nuevos a partir de ese momento.

8. Haz clic en Guardar.

Descargar un recurso de código

Sigue estos pasos para descargar un recurso de código en BigQuery:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

3. Selecciona el recurso de código que quieras descargar.

4. Haz clic en Ver acciones > Descargar.

Cambiar el nombre de una carpeta o un recurso de código

Sigue estos pasos para cambiar el nombre de una carpeta o un recurso de código en BigQuery:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

3. Selecciona la carpeta o el recurso de código cuyo nombre quieras cambiar.

4. Haz clic en Ver acciones > Cambiar nombre.

5. En el cuadro de diálogo para cambiar el nombre del recurso, escribe el nuevo nombre.

6. Haz clic en Cambiar nombre.

Compartir una carpeta o un recurso de código

Sigue estos pasos para compartir una carpeta o un recurso de código en BigQuery:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

3. Selecciona la carpeta o el recurso de código que quieras compartir.

4. En el panel Permisos de uso compartido, haz clic en Añadir usuario o grupo.

5. En el campo New principals (Nuevos principales), introduce un principal.

6. Elige una de estas opciones:

   • En la lista Rol, selecciona uno de los siguientes roles para compartir un recurso de código, incluida una carpeta de usuario:

     • roles/dataform.codeOwner: puede realizar cualquier acción en el recurso de código, como eliminarlo o compartirlo.
     • roles/dataform.codeEditor: puede realizar cualquier acción en el recurso de código, excepto eliminarlo o compartirlo.
     • roles/dataform.codeCommenter: puede ver y comentar el recurso de código.
     • roles/dataform.codeViewer: puede ver el recurso de código.

   • En la lista Rol, selecciona uno de los siguientes roles para compartir una carpeta de equipo:

     • roles/dataform.teamFolderOwner: puede realizar cualquier acción en la carpeta de equipo, como eliminarla o compartirla.
     • roles/dataform.teamFolderContributor: puede realizar cualquier acción en la carpeta de equipo, excepto eliminarla o compartirla.
     • roles/dataform.teamFolderCommenter: puede ver y comentar la carpeta de equipo y los recursos de código que contiene.
     • roles/dataform.teamFolderViewer: puede ver la carpeta de equipo y los recursos de código que contiene.

7. Haz clic en Guardar.

8. Para volver a la página de información del cuaderno, haz clic en Cerrar.

Mover una carpeta o un recurso de código

Sigue estos pasos para mover una carpeta o un recurso de código en BigQuery:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

3. Selecciona la carpeta o el recurso de código que quieras mover.

4. Haz clic en Ver acciones > Mover.

5. En el cuadro de diálogo para mover el recurso, selecciona el usuario o la carpeta de equipo a los que quieras mover el recurso.

6. Haz clic en Mover.

Copiar una carpeta o un recurso de código

Sigue estos pasos para copiar una carpeta o un recurso de código en BigQuery:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

3. Selecciona la carpeta o el recurso de código que quieras copiar.

4. Haz clic en Ver acciones > Copiar.

5. En el cuadro de diálogo de copia de recursos, selecciona la carpeta de usuario o de equipo en la que quieras copiar el recurso.

6. Haz clic en Copiar.

Eliminar una carpeta o un recurso de código

Sigue estos pasos para eliminar una carpeta o un recurso de código en BigQuery:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en Archivos para abrir el explorador de archivos:

   

3. Selecciona la carpeta o el recurso de código que quieras eliminar.

4. Haz clic en Ver acciones > Eliminar.

5. En el cuadro de diálogo para eliminar el recurso, haz clic en Eliminar.

Siguientes pasos

• Organizar los recursos de código con carpetas
• Crear cuadernos
• Crear consultas guardadas
• Crear lienzos de datos
• Crear preparaciones de datos