Ordner erstellen und verwalten

Vorschau

Diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie gesehen“ verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Hinweis: Wenn Sie Feedback geben oder Support für diese Funktion anfordern möchten, senden Sie eine E‑Mail an [e-mail].

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 wie Notebooks, gespeicherte Abfragen, Data-Canvas und Dateien zur Datenaufbereitung organisieren und steuern. BigQuery bietet Nutzerordner, in denen Einzelpersonen ihre eigenen Code-Assets verwalten können, und Teamordner, in denen die Code-Assets eines Teams verwaltet werden können.

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.

Hinweise

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

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 zum Verwenden der BigQuery-Dateiauswahl benötigen.

Berechtigungen, die für einen Ordner erteilt werden, werden auf alle darin enthaltenen Dateien und Ordner übertragen.

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 des Löschens der Ressource, des Festlegens der IAM-Richtlinie und des Verschiebens der Ressource.
Code-Editor (roles/dataform.codeEditor)	Datei oder Ordner	Ermöglicht das Bearbeiten und Verwalten von Inhalten. Ein Nutzer mit dieser Rolle kann Ordnern Inhalte 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 Viewer (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 zum Erstellen neuer Dateien und Ordner in einem Projekt.

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

Rolle	Gewährt am	Berechtigungen und Anwendungsfälle
Teamordnerinhaber (roles/dataform.teamFolderOwner)	Teamordner	Gewährt die 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 die Inhaltsverwaltung 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.
Betrachter für Teamordner (roles/dataform.teamFolderViewer)	Teamordner	Lesezugriff auf einen Teamordner und dessen Inhalt. Ein Nutzer mit dieser Rolle kann einen Teamordner aufrufen und seine 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

• So erstellen Sie einen Ordner:
  • folders.create für den übergeordneten Nutzerordner, Teamordner oder das übergeordnete Projekt
  • folders.addContents für den übergeordneten Ordner oder Teamordner
• Eigenschaften eines Ordners abrufen: folders.get für den Ordner
• Inhalt eines Ordners oder Teamordners abfragen: folders.queryContents auf den Ordner
• Ordner aktualisieren: folders.update für den Ordner
• Ordner löschen: folders.delete auf 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
• Ordner verschieben:
  • 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)
• Teamordner erstellen: teamFolders.create für das Projekt
• Teamordner löschen: teamFolders.delete auf den Teamordner
• IAM-Richtlinie für einen Teamordner abrufen: teamFolders.getIamPolicy für den Teamordner
• IAM-Richtlinie für einen Teamordner festlegen: teamFolders.setIamPolicy im Teamordner
• Attribute eines Teamordners abrufen: teamFolders.get auf den Teamordner
• Teamordner aktualisieren: teamFolders.update im 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 Sie den linken Bereich nicht sehen, 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 Code-Region 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 aufzurufen, die andere Nutzer für Sie freigegeben haben.

Coderegion ändern

Sie können Ordner und Code-Assets in verschiedenen Code-Regionen haben. So ändern Sie die Code-Region, die Sie sich ansehen:

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 für den Bereich „Dateien“ ansehen > Code-Region wechseln.

4. Wählen Sie den Codebereich aus, den Sie sich ansehen möchten.

5. Klicken Sie auf Speichern.

Ordner oder Code-Asset erstellen

Mit dieser Anleitung können Sie die folgenden Ressourcen erstellen:

• Ein Nutzerordner oder ein 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 Stammknoten des Nutzers 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 Typ der Ressource aus, die 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 suchen Sie dann nach einer lokalen Datei, die Sie auswählen möchten.
   • Klicken Sie auf das Optionsfeld URL und geben Sie dann 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. Wenn Sie eine andere Region als den Standardwert auswählen, wird die von Ihnen 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, 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, mit Ausnahme des Löschens oder Freigebens.
     • 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 ansehen.

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. Wählen Sie den Ordner oder das Code-Asset aus, das Sie verschieben möchten.

4. Klicken Sie auf  Aktionen ansehen > Verschieben.

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

6. Klicken Sie auf Verschieben.

Ordner oder Code-Asset kopieren

So kopieren 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 Ordner oder das Code-Asset aus, das Sie kopieren möchten.

4. Klicken Sie auf  Aktionen ansehen > Kopieren.

5. Wählen Sie im Dialogfeld „Ressource kopieren“ den Nutzer- oder Teambereich 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. Wählen Sie den Ordner oder das Code-Asset aus, das Sie löschen möchten.

4. Klicken Sie auf  Aktionen ansehen > Löschen.

5. Klicken Sie im Dialogfeld zum Löschen der Ressource auf Löschen.

Nächste Schritte

• Code-Assets mit Ordnern organisieren
• Notebooks erstellen
• Gespeicherte Abfragen erstellen
• Daten-Canvasse erstellen
• Datenaufbereitungen erstellen