Ordner erstellen und verwalten

Im folgenden Dokument wird beschrieben, wie Sie Ordner in BigQuery erstellen und verwalten. Mit Ordnern können Sie den Zugriff auf Code-Assets mit einzelnen Dateien organisieren und steuern, z. B. Notebooks, gespeicherte Abfragen, Data Canvases und Dateien zur Datenvorbereitung. BigQuery bietet Nutzerordner für Einzelpersonen, um ihre eigenen Code-Assets zu verwalten, und Teamordner, um die Code-Assets eines Teams zu verwalten.

BigQuery-Ordner basieren auf Dataform.

Bevor Sie Ordner erstellen, sollten Sie sich mit der Funktionsweise von BigQuery-Ordnern vertraut machen. Lesen Sie dazu Code-Assets mit Ordnern organisieren.

Hinweis

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

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die entsprechenden IAM-Rollen für das Projekt, den Ordner oder die Ressource zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen der Aufgaben in diesem Dokument benötigen.

Bitten Sie Ihren Administrator, Ihnen die Rolle BigQuery-Nutzer (roles/bigquery.user) oder BigQuery Studio-Nutzer (roles/bigquery.studioUser) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie für die Verwendung des BigQuery-Dateibrowsers benötigen.

Berechtigungen, die für einen Ordner gewährt werden, werden an alle darin enthaltenen Dateien und Ordner weitergegeben.

Für Dateien und die Ordner, in denen sie enthalten sind, gilt Folgendes:

Rolle	Gewährt am	Berechtigungen und Anwendungsfälle
Code-Inhaber (roles/dataform.codeOwner)	Datei oder Ordner	Gewährt vollständige Kontrolle über eine Ressource im Datei- und Ordnersystem. Ein Nutzer mit dieser Rolle kann alle Aktionen ausführen, einschließlich Löschen der Ressource, Festlegen der IAM-Richtlinie und Verschieben der Ressource.
Code-Editor (roles/dataform.codeEditor)	Datei oder Ordner	Ermöglicht das Bearbeiten und Verwalten von Inhalten. Ein Nutzer mit dieser Rolle kann Inhalte zu Ordnern hinzufügen, Dateien bearbeiten und die IAM-Richtlinie für eine Datei oder einen Ordner abrufen. Diese Rolle ist auch für den Zielordner erforderlich, wenn eine Ressource verschoben wird.
Code Commenter (roles/dataform.codeCommenter)	Datei oder Ordner	Ermöglicht das Kommentieren von Code-Assets oder -Ordnern.
Code-Betrachter (roles/dataform.codeViewer)	Datei oder Ordner	Gewährt Lesezugriff. Ein Nutzer mit dieser Rolle kann den Inhalt von Dateien und Ordnern abfragen.
Code Creator (roles/dataform.codeCreator)	Projekt	Gewährt die Berechtigung, neue Dateien und Ordner in einem Projekt zu erstellen.

Die folgenden Rollen sind für die Verwaltung von Teamordnern spezifisch:

Rolle	Gewährt am	Berechtigungen und Anwendungsfälle
Team Folder Owner (roles/dataform.teamFolderOwner)	Teamordner	Gewährt vollständige Kontrolle über einen Teamordner im Datei- und Ordnersystem. Ein Nutzer mit dieser Rolle kann den Teamordner löschen und seine IAM-Richtlinie festlegen.
Team Folder Contributor (roles/dataform.teamFolderContributor)	Teamordner	Ermöglicht das Content-Management in einem Teamordner. Ein Nutzer mit dieser Rolle kann einen Teamordner aktualisieren.
Team Folder Commenter (roles/dataform.teamFolderCommenter)	Teamordner	Ermöglicht das Kommentieren eines Teamordners und der darin enthaltenen Code-Assets.
Team Folder Viewer (roles/dataform.teamFolderViewer)	Teamordner	Gewährt Lesezugriff auf einen Teamordner und dessen Inhalt. Ein Nutzer mit dieser Rolle kann einen Teamordner aufrufen und die zugehörige IAM-Richtlinie abrufen.
Team Folder Creator (roles/dataform.teamFolderCreator)	Projekt	Gewährt die Berechtigung, neue Teamordner in einem Projekt zu erstellen.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Ausführen der Aufgaben in diesem Dokument erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

• Ordner erstellen:
  • folders.create für den übergeordneten Nutzerordner, Teamordner oder das Projekt
  • folders.addContents für den übergeordneten Ordner oder Teamordner
• Attribute eines Ordners abrufen: folders.get für den Ordner
• Inhalt eines Ordners oder Teamordners abfragen: folders.queryContents für den Ordner
• Ordner aktualisieren: folders.update für den Ordner
• Ordner löschen: folders.delete für den Ordner
• IAM-Richtlinie für einen Ordner abrufen: folders.getIamPolicy für den Ordner
• IAM-Richtlinie für einen Ordner festlegen: folders.setIamPolicy für den Ordner
• So verschieben Sie einen Ordner:
  • folders.move für den Ordner, der verschoben wird
  • folders.addContents für den Zielordner oder Teamordner (nicht erforderlich, wenn Sie in einen Stammordner verschieben)
• Zum Erstellen eines Teamordners: teamFolders.create für das Projekt
• Teamordner löschen: teamFolders.delete für den Teamordner
• IAM-Richtlinie für einen Teamordner abrufen: teamFolders.getIamPolicy für den Teamordner
• IAM-Richtlinie für einen Teamordner festlegen: teamFolders.setIamPolicy für den Teamordner
• Attribute eines Teamordners abrufen: teamFolders.get für den Teamordner
• Teamordner aktualisieren: teamFolders.update für den Teamordner

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um vollen Zugriff auf alle Ordner und Dateien in Ihrem Projekt zu erhalten:

• Dataform-Administrator (roles/dataform.admin)
• Dataform-Bearbeiter (roles/dataform.editor)
• Dataform-Betrachter (roles/dataform.viewer)

Ressourcen ansehen

So rufen Sie Ordner und Code-Assets in BigQuery auf:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

   Wenn der linke Bereich nicht angezeigt wird, klicken Sie auf Linken Bereich maximieren, um ihn zu öffnen.

3. Führen Sie einen der folgenden Schritte aus, um Ordner und Code-Assets im ausgewählten Projekt und in der ausgewählten Coderegion aufzurufen:

   • Maximieren Sie den Knoten Nutzer (Ihre E-Mail-Adresse), um die von Ihnen erstellten Ordner und Dateien aufzurufen.
   • Maximieren Sie den Knoten Teamordner, um alle Teamordner aufzurufen, auf die Sie Zugriff haben.
   • Maximieren Sie den Knoten Für mich freigegeben, um alle Ordner und Dateien zu sehen, die andere Nutzer für Sie freigegeben haben.

Hinweis: Wenn Sie einen Ordner öffnen, wird oben in der Ordneransicht der vollständige Pfad zu Ihrem aktuellen Speicherort angezeigt. Der Pfad ist bis zu der Ebene des Ordners sichtbar, für den Sie Berechtigungen haben.

Standardregion für Code-Assets festlegen

Sie können Ordner und Code-Assets in verschiedenen Coderegionen haben.

Alle neuen Code-Assets in Ihrem Google Cloud -Projekt verwenden eine Standardregion. Nachdem das Asset erstellt wurde, können Sie seine Region nicht mehr ändern.

Wichtig: Wenn Sie die Region beim Erstellen eines Code-Assets ändern, wird diese Region zur Standardregion für alle nachfolgenden Code-Assets. Vorhandene Code-Assets sind davon nicht betroffen.

So legen Sie die Standardregion für neue Code-Assets fest:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Klicken Sie neben dem Projektnamen auf Aktionen im Dateibereich ansehen > Coderegion wechseln.

4. Wählen Sie die Coderegion aus, die Sie als Standard verwenden möchten.

5. Klicken Sie auf Speichern.

Eine Liste der unterstützten Regionen finden Sie unter BigQuery Studio-Standorte.

Ordnerinhalte aktualisieren

So sorgen Sie dafür, dass alle kürzlich von Ihnen vorgenommenen oder von anderen freigegebenen Änderungen im Dateibrowser sichtbar sind:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Wählen Sie den Ordner aus, den Sie aktualisieren möchten, z. B. den Stammknoten des Nutzers, den Stammordner eines Teams oder einen einzelnen Ordner.

4. Klicken Sie auf Aktionen ansehen > Inhalte aktualisieren.

Ordner- oder Code-Asset erstellen

Mit diesem Verfahren können Sie die folgenden Ressourcen erstellen:

• Ein Nutzerordner oder Code-Asset auf einer beliebigen Ebene.
• Ein Unterordner in einem Teamordner.
• Ein Code-Asset im Unterordner eines Teamordners.

Informationen zum Erstellen eines Teamordners finden Sie unter Teamordner erstellen.

So erstellen Sie einen Ordner oder ein Code-Asset in BigQuery:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Wählen Sie den Nutzerstammknoten oder den Ordner aus, in dem Sie die Ressource erstellen möchten.

4. Klicken Sie auf Aktionen ansehen > Erstellen und wählen Sie dann den Ressourcentyp aus, den Sie erstellen möchten.

5. Geben Sie im Bereich „Ressource erstellen“ einen Namen für die neue Ressource ein.

6. Klicken Sie auf Speichern.

Teamordner erstellen

So erstellen Sie einen Teamordner in BigQuery:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Wählen Sie den Stammknoten des Teamordners aus.

4. Klicken Sie auf Aktionen ansehen > Teamordner erstellen.

5. Geben Sie im Dialogfeld Teamordner erstellen einen Namen für den Teamordner ein.

6. Klicken Sie auf Erstellen.

Code-Asset hochladen

So laden Sie ein Code-Asset in BigQuery hoch:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Wählen Sie den Ordner aus, in den Sie das Code-Asset hochladen möchten.

4. Klicken Sie auf Aktionen ansehen > Hochladen und wählen Sie dann den Typ des Code-Assets aus, das Sie hochladen möchten.

5. Führen Sie im Bereich „Ressource hochladen“ einen der folgenden Schritte aus:

   • Klicken Sie auf das Optionsfeld Datei hochladen und wählen Sie eine lokale Datei aus.
   • Klicken Sie auf das Optionsfeld URL und geben Sie die URL für eine Code-Asset-Datei ein, die sich in einem GitHub-Repository befindet.

6. Geben Sie einen Namen für das Code-Asset ein.

7. Optional: Wählen Sie eine Region aus, in der das Code-Asset gespeichert werden soll.

   Hinweis: Wenn Sie eine andere Region als den Standardwert auswählen, wird die ausgewählte Region zur Standardregion, in der alle neuen Code-Assets erstellt werden.

8. Klicken Sie auf Speichern.

Code-Asset herunterladen

So laden Sie ein Code-Asset in BigQuery herunter:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Wählen Sie das Code-Asset aus, das Sie herunterladen möchten.

4. Klicken Sie auf Aktionen ansehen > Herunterladen.

Ordner oder Code-Asset umbenennen

So benennen Sie einen Ordner oder ein Code-Asset in BigQuery um:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Wählen Sie den Ordner oder das Code-Asset aus, den bzw. das Sie umbenennen möchten.

4. Klicken Sie auf Aktionen ansehen > Umbenennen.

5. Geben Sie im Dialogfeld zum Umbenennen der Ressource einen neuen Namen für die Ressource ein.

6. Klicken Sie auf Umbenennen.

Ordner oder Code-Asset freigeben

So geben Sie einen Ordner oder ein Code-Asset in BigQuery frei:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Wählen Sie den Ordner oder das Code-Asset aus, das Sie freigeben möchten.

4. Klicken Sie im Bereich Freigabeberechtigungen auf Nutzer/Gruppe hinzufügen.

5. Geben Sie im Feld Neue Hauptkonten ein Hauptkonto ein.

6. Führen Sie einen der folgenden Schritte aus:

   • Wählen Sie in der Liste Rolle eine der folgenden Rollen aus, um ein Code-Asset, einschließlich eines Nutzerordners, freizugeben:

     • roles/dataform.codeOwner: Kann alle Aktionen für das Code-Asset ausführen, einschließlich Löschen oder Freigeben.
     • roles/dataform.codeEditor: Kann alle Aktionen für das Code-Asset ausführen, außer es zu löschen oder freizugeben.
     • roles/dataform.codeCommenter: Kann das Code-Asset ansehen und kommentieren.
     • roles/dataform.codeViewer: Kann das Code-Asset ansehen.

   • Wählen Sie in der Liste Rolle eine der folgenden Rollen aus, um einen Teamordner freizugeben:

     • roles/dataform.teamFolderOwner: Kann alle Aktionen für den Teamordner ausführen, einschließlich Löschen oder Freigeben.
     • roles/dataform.teamFolderContributor: Kann alle Aktionen für den Teamordner ausführen, außer ihn zu löschen oder freizugeben.
     • roles/dataform.teamFolderCommenter: Kann den Teamordner und die darin enthaltenen Code-Assets ansehen und kommentieren.
     • roles/dataform.teamFolderViewer: Kann den Teamordner und die darin enthaltenen Code-Assets aufrufen.

7. Klicken Sie auf Speichern.

8. Klicken Sie auf Schließen, um zur Seite mit den Notebook-Informationen zurückzukehren.

Ordner oder Code-Asset verschieben

So verschieben Sie einen Ordner oder ein Code-Asset in BigQuery:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Je nachdem, wie viele Ressourcen Sie verschieben möchten, haben Sie folgende Möglichkeiten:

   • Einzelne Ressource verschieben: Wählen Sie im Dateibrowser den Ordner oder das Code-Asset aus, das Sie verschieben möchten, und klicken Sie dann auf Aktionen ansehen > Verschieben.
   • Mehrere Ressourcen verschieben: Wählen Sie in der Ordneransicht das Kästchen neben jeder Ressource aus, die Sie verschieben möchten, und klicken Sie dann auf Verschieben.

4. Wählen Sie im Dialogfeld „Ressource verschieben“ den Nutzer- oder Teamordner aus, in den Sie die Ressource verschieben möchten.

5. Klicken Sie auf Verschieben.

Hinweis: Bulk-Verschiebevorgänge sind unabhängig voneinander. Wenn eine Ressource nicht verschoben werden kann, wird trotzdem versucht, alle anderen ausgewählten Ressourcen zu verschieben.

Code-Asset kopieren

So kopieren Sie ein Code-Asset in BigQuery:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Wählen Sie das Code-Asset aus, das Sie kopieren möchten.

4. Klicken Sie auf Aktionen ansehen > Kopieren.

5. Wählen Sie im Dialogfeld zum Kopieren von Ressourcen den Nutzer- oder Teamordner aus, in den Sie die Ressource kopieren möchten.

6. Klicken Sie auf Kopieren.

Ordner oder Code-Asset löschen

So löschen Sie einen Ordner oder ein Code-Asset in BigQuery:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:

   

3. Führen Sie je nachdem, wie viele Ressourcen Sie löschen möchten, einen der folgenden Schritte aus:

   • Einzelne Ressource löschen: Wählen Sie im Dateibrowser den Ordner oder das Code-Asset aus, das Sie löschen möchten, und klicken Sie dann auf Aktionen ansehen > Löschen.
   • Mehrere Ressourcen löschen: Wählen Sie in der Ordneransicht das Kästchen neben jeder Ressource aus, die Sie löschen möchten, und klicken Sie dann auf Löschen.

4. Klicken Sie im Dialogfeld „Ressource löschen“ auf Löschen.

Hinweis: Wenn Sie mehrere Ressourcen löschen, müssen die ausgewählten Ordner leer sein, damit der Vorgang erfolgreich ist. Bulk-Löschvorgänge sind unabhängig voneinander. Wenn eine Ressource nicht gelöscht werden kann, wird trotzdem versucht, alle anderen ausgewählten Ressourcen zu löschen.

Nächste Schritte

• Code-Assets mit Ordnern organisieren
• Notebooks erstellen
• Gespeicherte Abfragen erstellen
• Data Canvases erstellen
• Datenvorbereitungen erstellen