Fehlerbehebung bei Dataform

In diesem Dokument wird beschrieben, wie Sie Probleme mit Dataform beheben.

Zugriff auf BigQuery verweigert

Der folgende Fehler tritt auf, wenn Sie einen Workflowaufruf vor dem Dataform Zugriff auf BigQuery gewähren:

Access Denied: Project PROJECT_ID: User does not have bigquery.jobs.create permission in project PROJECT_ID.

Um diesen Fehler zu beheben, gewähren Sie Dataform Zugriff auf BigQuery

Zugriffstoken für ein Remote-Repository wird abgelehnt

Der folgende Fehler tritt auf, wenn Ihr Authentifizierungstoken für ein verbundenes Repository eines Drittanbieters keinen Zugriff auf dieses Repository hat:

The access token for remote repository REPOSITORY_NAME was rejected

Prüfen Sie die erforderlichen Berechtigungen bei Ihrem Git-Anbieter und aktualisieren Sie das Secret Manager-Authentifizierungstoken entsprechend, um diesen Fehler zu beheben. Weitere Informationen Informationen zur Authentifizierung von Git-Repositories von Drittanbietern in Dataform, siehe Verbindung zu Git von Drittanbietern 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 in auf folgende Arten:

Eine Anleitung zum Beheben dieses Fehlers in BigQuery finden Sie unter Fehlerbehebung bei Kontingent- und Limits-Fehlern.

Limit für Nebenläufigkeit von BigQuery-Abfragen wurde überschritten

Der folgende Fehler tritt auf, wenn die Anzahl der gleichzeitigen Abfragen, die in BigQuery ausgeführt werden, das Limit für die BigQuery-Abfrageparallelität überschreitet:

Exceeded rate limits: too many concurrent queries for this project_and_region

Reduzieren Sie die Anzahl der parallelen Abfragen in auf folgende Arten:

Eine Anleitung zum Beheben dieses Fehlers in BigQuery finden Sie unter Fehlerbehebung bei Kontingent- und Limits-Fehlern.

Fehler bei der BigQuery-Workflowausführung

Die folgenden Fehler treten bei der Ausführung eines SQL-Workflows in BigQuery auf:

Informationen zum Beheben dieser Fehler finden Sie unter BigQuery-Fehler Nachrichten

In Konflikt stehende includeDependentAssertions-Properties

Der folgende Fehler tritt während der Kompilierung auf, wenn der Der Parameter includeDependentAssertions ist auf denselben Wert Aktion mit unterschiedlichen Werten in einer Datei:

Conflicting "includeDependentAssertions" properties are not allowed. Dependency
dependencyName has different values set for this property.

Bearbeiten Sie die Datei und entfernen Sie widersprüchliche Wiederholungen der includeDependentAssertions-Parameter.

Weitere Informationen zum Festlegen von Behauptungen als Abhängigkeiten mit dem Parameter includeDependentAssertions finden Sie unter Behauptungen einer ausgewählten Aktion als Abhängigkeiten festlegen.

Kompilierung fehlgeschlagen

Die folgenden Fehler treten während der Kompilierung aufgrund der Größe oder Anzahl der kompilierten Suchanfragen:

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

  1. Dataform Core auf die neueste Version aktualisieren Version.
  2. Prüfen Sie Ihren SQL-Workflow, um Ineffizienzen zu identifizieren und zu reduzieren.
  3. Verringern Sie die Größe der SQL-Abfragen.

  4. Reduzieren Sie die Anzahl der JavaScript-Vorgänge im Arbeitsspeicher, z. B.:

    config { config {type: "table" }}
js {
    const tooBig = new Uint8Array(110_000_000);
}
SELECT ...

  5. Teilen Sie das Repository auf.

Weitere Informationen zu den Limits für Ressourcen zur Zusammenstellung von Dataform-Objekten finden Sie unter Kontingente und Limits.

@dataform/core Abhängigkeitsfehler

Die folgenden Fehler treten während der Kompilierung auf, wenn die Abhängigkeit dataform-core in package.json ist veraltet:

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 in Dataform automatisch mit der aktuellen Version von @dataform/core ausgefüllt. Sie müssen @dataform/core auf die neueste Version aktualisieren, sobald diese verfügbar ist.

Aktualisieren Sie @dataform/core auf die aktuellste Version, um diese Fehler zu beheben.

dataform.json konnte nicht aufgelöst werden

Der folgende Fehler tritt auf, wenn Sie einen Dataform-Arbeitsbereich initialisieren, aber bei der Initialisierung 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: Beim Initialisierungsprozess werden jedoch nicht alle Pakete installiert:

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 Pakete in package.json mit Ziele mit dem Präfix git+:

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

Um diesen Fehler zu beheben, generieren Sie eine tar.gz-URL für das Paket und aktualisieren Sie das Paketziel in package.json. 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 Größe der Pakete überschreitet die maximale Größe von NPM. dependencies:

API request error: Package installation timed out

Entfernen Sie redundante Pakete aus package.json, um diesen Fehler zu beheben. Achten Sie darauf, dass die package.json-Datei keine @dataform/cli enthält und dass die Gesamtgröße der definierten NPM-Abhängigkeiten 200 MB nicht überschreitet.

Wenn Ihre Release-Konfigurationen auf Git-Commits verweisen, müssen die package.json-Dateien an ihren Zielen gültig sein.

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 für die private 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 auf, weil Git instabil ist oder wenn ein Zweigname im Das verbundene Git-Repository eines Drittanbieters enthält ein Nicht-ASCII- oder Nicht-Englisches Zeichen:

Remote repository REPOSITORY_NAME could not be reached.

Prüfen Sie die Zweignamen im verbundenen Drittanbieter, um diesen Fehler zu beheben zu erstellen. Wenn ein Zweigname ein Nicht-ASCII-Zeichen oder ein 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 ein bei einem geplanten Release gelegentlich ein langsames, instabiles oder ausfallendes GitHub-Protokoll, GitLab- oder Bitbucket-Verbindung:

generic::invalid_argument: Remote repository 'REMOTE_REPOSITORY_URL' could not be reached.

Sie müssen nichts weiter tun. Außer GitHub, GitLab oder Bitbucket Cloud weiterhin auftreten, können nachfolgende geplante Releases erfolgreich sein.

Secret für ein Remote-Repository ist nicht erreichbar

Der folgende Fehler tritt auf, wenn Ihr Dataform-Dienstkonto keine Auf Secret Manager-Secret für einen verbundenen Drittanbieter zugreifen Repository:

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.