In diesem Dokument erfahren Sie, wie Sie Probleme mit Dataform beheben.
Zugriff auf BigQuery verweigert
Der folgende Fehler tritt auf, wenn Sie einen Workflowaufruf auslösen, bevor Sie Dataform Zugriff auf BigQuery gewähren:
Access Denied: Project PROJECT_ID: User does not have bigquery.jobs.create permission in project PROJECT_ID.
Gewähren Sie Dataform Zugriff auf BigQuery, um diesen Fehler zu beheben.
Zugriffstoken für ein Remote-Repository wurde abgelehnt
Der folgende Fehler tritt auf, wenn das Authentifizierungstoken für ein verbundenes Drittanbieter-Repository keinen Zugriff auf dieses Repository hat:
The access token for remote repository REPOSITORY_NAME was rejected
Prüfen Sie die erforderlichen Berechtigungen in Ihrem Git-Anbieter und aktualisieren Sie das Authentifizierungstoken von Secret Manager entsprechend, um diesen Fehler zu beheben. Weitere Informationen zur Authentifizierung von Git-Repositories von Drittanbietern in Dataform finden Sie unter Verbindung zu einem Git-Repository eines Drittanbieters herstellen.
BigQuery-Kontingent wurde überschritten
Der folgende Fehler tritt auf, wenn die Anzahl der API-Anfragen, die Dataform an BigQuery sendet, das BigQuery-Kontingent überschreitet:
Quota exceeded: Your user_method exceeded quota for concurrent api requests
per user per method.
Reduzieren Sie die Anzahl der parallelen Abfragen auf folgende Weise auf weniger als 250, um diesen Fehler zu beheben:
- In Dataform können Sie Aktionen mit Tags kategorisieren und nur ausgewählte Tags gleichzeitig ausführen.
- Richten Sie in Dataform Abhängigkeiten zwischen Aktionen ein.
- Teilen Sie in Dataform die Ausführung von Aktionen auf verschiedene Google Cloud-Projekte auf.
Eine Anleitung zum Beheben dieses Fehlers in BigQuery finden Sie unter Kontingent- und Limitfehler beheben.
Limit für Nebenläufigkeit von BigQuery-Abfragen wurde überschritten
Der folgende Fehler tritt auf, wenn die Anzahl der gleichzeitig in BigQuery ausgeführten Abfragen das Nebenläufigkeitslimit für BigQuery-Abfragen überschreitet:
Exceeded rate limits: too many concurrent queries for this project_and_region
Reduzieren Sie die Anzahl der parallelen Abfragen auf folgende Weise auf weniger als 250, um diesen Fehler zu beheben:
- In Dataform können Sie Aktionen mit Tags kategorisieren und nur ausgewählte Tags gleichzeitig ausführen.
- Richten Sie in Dataform Abhängigkeiten zwischen Aktionen ein.
- Teilen Sie in Dataform die Ausführung von Aktionen auf verschiedene Google Cloud-Projekte auf.
Eine Anleitung zum Beheben dieses Fehlers in BigQuery finden Sie unter Kontingent- und Limitfehler beheben.
Fehler beim Aufrufen von BigQuery-Workflows
Die folgenden Fehler treten bei der Ausführung eines SQL-Workflows in BigQuery auf:
- Workflowaufruffehler, die mit BigQuery-Fehlermeldungen beginnen.
Informationen zum Beheben dieser Fehler finden Sie unter BigQuery-Fehlermeldungen.
In Konflikt stehende includeDependentAssertions
Properties
Der folgende Fehler tritt während der Kompilierung auf, wenn der Parameter includeDependentAssertions
für dieselbe Aktion mit unterschiedlichen Werten in einer Datei festgelegt wird:
Conflicting "includeDependentAssertions" properties are not allowed. Dependency
dependencyName has different values set for this property.
Bearbeiten Sie die Datei und entfernen Sie in Konflikt stehende Wiederholungen des includeDependentAssertions
-Parameters, um diesen Fehler zu beheben.
Weitere Informationen zur Verwendung des Parameters includeDependentAssertions
zum Festlegen von Assertions als Abhängigkeiten finden Sie unter Assertions einer ausgewählten Aktion als Abhängigkeiten festlegen.
Kompilierung schlägt fehl
Die folgenden Fehler treten während der Kompilierung aufgrund der Größe oder Anzahl der kompilierten Abfragen auf:
Compilation timed out. Reduce the complexity of your project to ensure it can compile within limits.
Compilation exceeded its allowed heap memory limits. Reduce the complexity of your project to ensure it can compile within limits.
Compilation exceeded its allowed ArrayBuffer or string memory limits. Reduce the complexity of your project to ensure it can compile within limits.
So beheben Sie diese Fehler:
- Aktualisieren Sie Dataform Core auf die neueste Version.
- Prüfen Sie Ihren SQL-Workflow, um Ineffizienzen zu identifizieren und zu reduzieren.
- Reduzieren Sie die Größe von SQL-Abfragen.
Reduzieren Sie die Anzahl der JavaScript-Vorgänge im Arbeitsspeicher. Beispiele:
config { config {type: "table" }} js { const tooBig = new Uint8Array(110_000_000); } SELECT ...
Weitere Informationen zu den Limits für Kompilierungsressourcen in Dataform finden Sie unter Kontingente und Limits.
@dataform/core
Abhängigkeitsfehler
Die folgenden Fehler treten während der Kompilierung auf, wenn die dataform-core
-Abhängigkeit in package.json
veraltet ist:
Failed to resolve @dataform/core
@dataform/core version should be X.X.X or newer
Die Abhängigkeit @dataform/core
ist in package.json
erforderlich. Wenn Sie den ersten Arbeitsbereich in Ihrem Repository initialisieren, wird package.json
von Dataform automatisch mit der aktuellen Version von @dataform/core
gefüllt. Du musst @dataform/core
auf die neueste Version aktualisieren, sobald sie veröffentlicht wird.
Aktualisieren Sie @dataform/core
auf die neueste Version, um diese Fehler zu beheben.
dataform.json
konnte nicht aufgelöst werden
Der folgende Fehler tritt auf, wenn Sie einen Dataform-Arbeitsbereich initialisieren, bei der Initialisierung jedoch nicht alle Pakete installiert werden:
Uncaught Error: Failed to resolve dataform.json
Öffnen Sie in Ihrem Arbeitsbereich package.json
und klicken Sie auf Pakete installieren, um diesen Fehler zu beheben.
workflow_settings.yaml
konnte nicht aufgelöst werden
Der folgende Fehler tritt auf, wenn Sie einen Dataform-Arbeitsbereich initialisieren, bei der Initialisierung jedoch nicht alle Pakete installiert werden:
Uncaught Error: Failed to resolve workflow_settings.yaml
Öffnen Sie in Ihrem Arbeitsbereich workflow_settings.yaml
und klicken Sie auf Pakete installieren, um diesen Fehler zu beheben.
git+
Paketziele werden nicht unterstützt
Der folgende Fehler tritt auf, wenn Sie in package.json
Pakete mit Zielen mit dem Präfix git+
definieren:
'git+' prefixed package targets are not currently supported. However,
in most cases they can be used via a '.tar.gz' suffixed target instead.
Dataform unterstützt keine Paketziele mit dem Präfix git+
.
Generieren Sie eine tar.gz
-URL des Pakets und aktualisieren Sie das Paketziel in package.json
, um diesen Fehler zu beheben. Weitere Informationen zum Installieren von Paketen in Dataform finden Sie unter Paket in Dataform installieren.
Zeitüberschreitung bei der Paketinstallation
Der folgende Fehler tritt auf, wenn die in package.json
definierte Paketgröße die maximale Größe der NPM-Abhängigkeiten überschreitet:
API request error: Package installation timed out
Entfernen Sie redundante Pakete aus package.json
, um diesen Fehler zu beheben. Achten Sie darauf, dass die Datei package.json
nicht @dataform/cli
enthält und dass die Gesamtgröße der definierten NPM-Abhängigkeiten 200 MB nicht überschreitet.
Wenn Ihre Releasekonfigurationen auf Git-Commits verweisen, prüfen Sie, ob die package.json
-Dateien an ihren Zielen gültig sind.
Private Paket-Registry ist nicht erreichbar
Der folgende Fehler tritt auf, wenn die Dataform-Authentifizierung für ein privates Paket abläuft:
Permission denied when fetching one or more npm packages. Please verify that
private registry authentication details are valid for each npm registry
Prüfen Sie, ob die Authentifizierungsdetails der privaten Registry für jede NPM-Registry gültig sind, um diesen Fehler zu beheben. Weitere Informationen finden Sie unter Privates Paket in Dataform authentifizieren.
Remote-Repository ist nicht erreichbar
Der folgende Fehler tritt aufgrund von Git-Flakiness auf oder wenn ein Zweigname im verbundenen Drittanbieter-Git-Repository ein Nicht-ASCII- oder nicht englisches Zeichen enthält:
Remote repository REPOSITORY_NAME could not be reached.
Prüfen Sie die Zweignamen im verbundenen Drittanbieter-Repository, um diesen Fehler zu beheben. Wenn ein Zweig ein Nicht-ASCII- oder nicht englisches Zeichen enthält, löschen Sie den Zweig.
Remote-Repository ist nicht erreichbar: generic::invalid_argument
Der folgende Fehler tritt auf der Seite Release-Konfigurationsdetails auf, wenn bei einem geplanten Release gelegentlich eine langsame, instabile oder unterbrochene GitHub-, GitLab- oder Bitbucket-Verbindung auftritt:
generic::invalid_argument: Remote repository 'REMOTE_REPOSITORY_URL' could not be reached.
Sie müssen nichts weiter tun. Wenn Probleme mit GitHub, GitLab oder Bitbucket Cloud nicht bestehen, können die nachfolgenden geplanten Releases erfolgreich sein.
Secret für ein Remote-Repository ist nicht erreichbar
Der folgende Fehler tritt auf, wenn Ihr Dataform-Dienstkonto nicht auf das Secret Manager-Secret für ein verbundenes Drittanbieter-Repository zugreifen kann:
Dataform's service account is unable to reach the configured secret.
Make sure the secret exists and is shared with your Dataform service account:
SERVICE_ACCOUNT_ID.
So beheben Sie diesen Fehler:
- Prüfen Sie, ob Ihr Dataform-Dienstkonto Zugriff auf das Secret hat.
- Schließen Sie das Secret aus dem VPC-SC-Dienstperimeter aus. Dataform unterstützt VPC-SC derzeit nicht.