Crea y administra carpetas

En el siguiente documento, se describe cómo crear y administrar carpetas en BigQuery. Puedes usar carpetas para organizar y controlar el acceso a los recursos 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 aprender cómo funcionan las carpetas de BigQuery.

Antes de comenzar

1. 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

2. Verify that billing is enabled for your Google Cloud project.

3. Enable the BigQuery and Dataform APIs, if any are not already enabled.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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 navegador 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.

Las siguientes reglas se aplican a los archivos y las carpetas que los contienen:

Rol	Otorgado 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 para 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.
Vista 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 en un proyecto.

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

Rol	Otorgado 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 administrar el contenido 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 de usuario, la carpeta de equipo o el proyecto superiores
  • folders.addContents en la carpeta superior o de 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
• Borrar una carpeta: folders.delete en la carpeta
• Obtener 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
• Mueve una carpeta:
  • folders.move en la carpeta que se está moviendo
  • folders.addContents en la carpeta de destino o de equipo (no es necesario si se mueve a una carpeta raíz)
• Crea una carpeta de equipo: teamFolders.create en el proyecto
• Borrar una carpeta de equipo: teamFolders.delete en la carpeta de equipo
• Obtén la política de IAM para una carpeta de equipo: teamFolders.getIamPolicy en la carpeta de equipo
• Establece la política de IAM para una carpeta de equipo: teamFolders.setIamPolicy en la carpeta de equipo
• Recupera 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 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 recursos 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 de equipo para ver todas las carpetas de equipo a las que tienes acceso.
   • Expande el nodo Compartidos conmigo para ver todas las carpetas y los archivos que otros usuarios compartieron contigo.

Nota: Cuando abres una carpeta, la ruta de navegación que se encuentra en la parte superior de la vista de la carpeta muestra la ruta de acceso completa a tu ubicación actual. La ruta es visible hasta el nivel de la carpeta para la que tienes permisos.

Configura la región predeterminada para los elementos de código

Puedes tener carpetas y recursos de código en diferentes regiones de código.

Todos los elementos de código nuevos de tu proyecto de Google Cloud usan una región predeterminada. Después de crear el recurso, no puedes cambiar su región.

Importante: Si cambias la región mientras creas un recurso de código, esa región se convierte en la predeterminada para todos los recursos de código posteriores. Los recursos de código existentes no se ven afectados.

Para configurar la región predeterminada de los elementos de código nuevos, haz lo siguiente:

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 Ver acciones del panel de archivos > Cambiar región de código.

4. Selecciona la región de código que quieres usar como predeterminada.

5. Haz clic en Guardar.

Para obtener una lista de las regiones admitidas, consulta Ubicaciones de BigQuery Studio.

Actualizar el contenido de la carpeta

Para asegurarte de que los cambios recientes que realizaste o que compartieron otras personas sean visibles en el navegador de archivos, haz lo siguiente:

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 que quieras actualizar, como el nodo raíz del usuario, la raíz de una carpeta de equipo o una carpeta individual.

4. Haz clic en Ver acciones > Actualizar contenido.

Crea un recurso de carpeta o código

Usa este procedimiento para crear cualquiera de los siguientes recursos:

• Una carpeta de usuario o un recurso de código en cualquier nivel.
• Una subcarpeta en 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 quieres 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 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.

Sube 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 carga de recursos, realiza una de las siguientes acciones:

   • Haz clic en el botón de selección Subir archivo y, luego, busca y selecciona un archivo local.
   • Haz clic en el botón de selección URL y, luego, 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 se almacenará el recurso de código.

   Nota: 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.

Cambia 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 recurso de código al que quieras cambiarle el nombre.

4. Haz clic en Ver acciones > Cambiar nombre.

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

6. Haga clic en Cambiar nombre.

Cómo 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 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, como borrarlo o compartirlo.
     • 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 en é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 de equipo, como borrarla o compartirla.
     • roles/dataform.teamFolderContributor: Puede realizar cualquier acción en la carpeta de 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 un recurso de carpeta o 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. Según la cantidad de recursos que quieras mover, realiza una de las siguientes acciones:

   • Mover un solo recurso: En el navegador de archivos, selecciona la carpeta o el recurso de código que deseas mover y, luego, haz clic en Ver acciones > Mover.
   • Mover varios recursos: En la vista de carpetas, selecciona la casilla de verificación junto a cada recurso que quieras mover y, luego, haz clic en Mover.

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

5. Haz clic en Mover.

Nota: Las operaciones de transferencia masiva son independientes. Si un recurso no se mueve, la operación aún intenta completar el traslado de todos los demás recursos seleccionados.

Cómo copiar un recurso de código

Sigue estos pasos para copiar 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 copiar.

4. Haz clic en Ver acciones > Copiar.

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

6. Haz clic en Copiar.

Borra una carpeta o un recurso 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. Según la cantidad de recursos que quieras borrar, realiza una de las siguientes acciones:

   • Borra un solo recurso: En el navegador de archivos, selecciona la carpeta o el recurso de código que deseas borrar y, luego, haz clic en Ver acciones > Borrar.
   • Borra varios recursos: En la vista de carpetas, selecciona la casilla de verificación junto a cada recurso que quieras borrar y, luego, haz clic en Borrar.

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

Nota: Cuando borres varios recursos, las carpetas seleccionadas deben estar vacías para que la operación se realice correctamente. Las operaciones de eliminación masiva son independientes; si un recurso no se borra, la operación intenta completar la eliminación de todos los demás recursos seleccionados.

¿Qué sigue?

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