Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

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

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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.

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

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.

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

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 zugehörigen 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	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

Ordner erstellen:
- 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
Inhalte 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:

Rufen Sie die Seite BigQuery auf.

BigQuery aufrufen
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.
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.

Standardregion für Code-Assets festlegen

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

Für alle neuen Code-Assets in Ihrem Google Cloud -Projekt wird eine Standardregion verwendet. Nachdem das Asset erstellt wurde, können Sie seine Region nicht mehr ändern.

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

Rufen Sie die Seite BigQuery auf.

BigQuery aufrufen
Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen:
Klicken Sie neben dem Projektnamen auf Aktionen für den Bereich „Dateien“ ansehen > Code-Region wechseln.
Wählen Sie die Code-Region aus, die Sie als Standard verwenden möchten.
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 aktuellen Änderungen, die Sie vorgenommen oder die andere mit Ihnen geteilt haben, im Dateibrowser sichtbar sind:

Rufen Sie die Seite BigQuery auf.

BigQuery aufrufen
Klicken Sie im linken Bereich auf Dateien, um den Dateibrowser zu öffnen: