Crea y administra carpetas

Versión preliminar

Esta función está sujeta a las “Condiciones de la Oferta de la Fase Previa a la DG” en la sección Condiciones del Servicio Generales de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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

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

Las carpetas de BigQuery funcionan con Dataform.

Antes de crear carpetas, lee Organiza los recursos de código con carpetas para saber cómo funcionan las carpetas de BigQuery.

Antes de comenzar

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, pídele a tu administrador que te otorgue los roles de IAM adecuados en el proyecto, la carpeta o el recurso.

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

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

Los siguientes requisitos se aplican a los archivos y las carpetas que los contienen:

Rol	Se otorgó el	Permisos y casos de uso
Propietario del código (roles/dataform.codeOwner)	Archivo o carpeta	Otorga control total sobre un recurso en el sistema de archivos y carpetas. Un usuario con este rol puede realizar todas las acciones, como borrar el recurso, establecer su política de IAM y moverlo.
Editor de código (roles/dataform.codeEditor)	Archivo o carpeta	Permite editar y administrar contenido. Un usuario con este rol puede agregar contenido a las carpetas, editar archivos y obtener la política de IAM de un archivo o una carpeta. Este rol también es obligatorio en la carpeta de destino cuando se mueve un recurso.
Comentarista de código (roles/dataform.codeCommenter)	Archivo o carpeta	Permite comentar recursos o carpetas de código.
Visualizador 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	Otorga permiso para crear archivos y carpetas nuevos dentro de un proyecto.

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

Rol	Se otorgó el	Permisos y casos de uso
Propietario de la carpeta de equipo (roles/dataform.teamFolderOwner)	Carpeta de equipo	Otorga control total sobre una carpeta de equipo en el sistema de archivos y carpetas. Un usuario con este rol puede borrar la carpeta del equipo y establecer su política de IAM.
Colaborador de carpetas de equipo (roles/dataform.teamFolderContributor)	Carpeta de equipo	Permite la administración de contenido dentro de una carpeta de equipo. Un usuario con este rol puede actualizar una carpeta de equipo.
Comentarista de carpetas de equipo (roles/dataform.teamFolderCommenter)	Carpeta de equipo	Permite comentar una carpeta de equipo y los recursos de código que contiene.
Visualizador de carpetas de equipo (roles/dataform.teamFolderViewer)	Carpeta de equipo	Proporciona acceso de solo lectura a una carpeta de equipo y su contenido. Un usuario con este rol puede ver una carpeta de equipo y obtener su política de IAM.
Creador de carpetas de equipo (roles/dataform.teamFolderCreator)	Proyecto	Otorga permiso para crear carpetas de equipo nuevas dentro de un proyecto.

Para obtener más información sobre cómo otorgar roles, consulta Administra el 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 son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

• Crea una carpeta:
  • folders.create en la carpeta del usuario principal, la carpeta del equipo o el proyecto
  • folders.addContents en la carpeta superior o la carpeta del equipo
• Recupera 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
• Borra una carpeta: folders.delete en la carpeta
• Obtén la política de IAM para una carpeta: folders.getIamPolicy en la carpeta
• Establece la política de IAM para una carpeta: folders.setIamPolicy en la carpeta
• Sigue estos pasos para mover una carpeta:
  • folders.move en la carpeta que se está moviendo
  • folders.addContents en la carpeta de destino o en la carpeta del equipo (no es necesario si se mueve a una carpeta raíz)
• Crea una carpeta de equipo: teamFolders.create en el proyecto.
• Borra una carpeta del equipo: teamFolders.delete en la carpeta del equipo
• Obtén la política de IAM de una carpeta de equipo: teamFolders.getIamPolicy en la carpeta de equipo
• Establece la política de IAM para una carpeta del equipo: teamFolders.setIamPolicy en la carpeta del equipo
• Recupera las propiedades de una carpeta de equipo: teamFolders.get en la carpeta de equipo
• Actualiza una carpeta de equipo: teamFolders.update en la carpeta de equipo

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

Para obtener acceso completo a todas las carpetas y archivos de tu proyecto, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

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

Ver recursos

Sigue estos pasos para ver las carpetas y los elementos de código en BigQuery:

1. Ve a la página de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador de archivos:

   

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

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

   • Expande el nodo Usuario (tu dirección de correo electrónico) para ver las carpetas y los archivos que creaste.
   • Expande el nodo Carpetas del equipo para ver todas las carpetas del equipo a las que tienes acceso.
   • Expande el nodo Compartidos conmigo para ver todas las carpetas y los archivos que otros usuarios compartieron contigo.

Cómo 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 del código que estás viendo:

1. Ve a la página de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador de archivos:

   

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

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

5. Haz clic en Guardar.

Crea una carpeta o un recurso de código

Usa este procedimiento para crear cualquiera de los siguientes recursos:

• Es una carpeta del usuario o un recurso de código en cualquier nivel.
• Es 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 Crea 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 de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador de archivos:

   

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

4. Haz clic en Ver acciones > Crear y, luego, selecciona el tipo de recurso que deseas crear.

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

6. Haz clic en Guardar.

Cree una carpeta para el equipo

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

1. Ve a la página de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador de archivos:

   

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

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

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

6. Haz clic en Crear.

Cómo subir un recurso de código

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

1. Ve a la página de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador de archivos:

   

3. Selecciona la carpeta a la que quieres subir el recurso de código.

4. Haz clic en Ver acciones > Subir y, luego, selecciona el tipo de recurso de código que deseas subir.

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

   • Haz clic en el botón de opción File upload y, luego, busca y selecciona un archivo local.
   • Haz clic en el botón de opción URL y, luego, escribe la URL de un archivo de recursos 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 diferente del valor predeterminado, la región que selecciones se convertirá en la región predeterminada en la que se crearán todos los elementos de código nuevos en el futuro.

8. Haz clic en Guardar.

Descarga un recurso de código

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

1. Ve a la página de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador de archivos:

   

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

4. Haz clic en Ver acciones > Descargar.

Cómo 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 de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador de archivos:

   

3. Selecciona la carpeta o el activo de código al que quieras cambiarle el nombre.

4. Haz clic en Ver acciones > Cambiar nombre.

5. En el diálogo de cambio de nombre del recurso, escribe un nombre nuevo para el recurso.

6. Haga clic en Cambiar nombre.

Comparte 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 de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador 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 Agregar usuario o grupo.

5. En el campo Principales nuevas, ingresa una principal.

6. Realiza una de las siguientes acciones:

   • 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, incluida la eliminación o el uso compartido.
     • roles/dataform.codeEditor: Puede realizar cualquier acción en el recurso de código, excepto borrarlo o compartirlo.
     • roles/dataform.codeCommenter: Puede ver el recurso de código y agregar comentarios sobre él.
     • 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 del equipo, incluida la eliminación o el uso compartido.
     • roles/dataform.teamFolderContributor: Puede realizar cualquier acción en la carpeta del equipo, excepto borrarla o compartirla.
     • roles/dataform.teamFolderCommenter: Puede ver y comentar la carpeta del equipo y los recursos de código que contiene.
     • roles/dataform.teamFolderViewer: Puede ver la carpeta del 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 notebook, haz clic en Cerrar.

Cómo 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 de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador de archivos:

   

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

4. Haz clic en Ver acciones > Mover.

5. En el diálogo para mover el recurso, selecciona la carpeta del usuario o del equipo a la que deseas mover el recurso.

6. Haz clic en Mover.

Cómo copiar una carpeta o un activo de código

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

1. Ve a la página de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador 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 diálogo de copia de recursos, selecciona la carpeta del usuario o del equipo a la que deseas copiar el recurso.

6. Haz clic en Copiar.

Cómo borrar una carpeta o un activo de código

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

1. Ve a la página de BigQuery.

   Ir a BigQuery

2. En el panel izquierdo, haz clic en Archivos para abrir el navegador de archivos:

   

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

4. Haz clic en Ver acciones > Borrar.

5. En el cuadro de diálogo para borrar el recurso, haz clic en Borrar.

¿Qué sigue?

• Organiza recursos de código con carpetas
• Crea notebooks
• Crea consultas guardadas
• Crea lienzos de datos
• Crea preparaciones de datos