Soluciona problemas de Dataform

En este documento, se muestra cómo resolver problemas con Dataform.

Se denegó el acceso a BigQuery

El siguiente error ocurre cuando activas una invocación de flujo de trabajo antes Otorga acceso de Dataform a BigQuery:

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

Para resolver este error, otorga a Dataform acceso a BigQuery

Se rechazó el token de acceso para un repositorio remoto

El siguiente error ocurre cuando tu token de autenticación para un servidor de terceros no tiene acceso a ese repositorio:

The access token for remote repository REPOSITORY_NAME was rejected

Para resolver este error, verifica los permisos necesarios en tu proveedor de Git y y actualizarás el token de autenticación de Secret Manager según corresponda. Para ver más más información sobre la autenticación de repositorios de Git de terceros en Dataform, consulta Conéctate a Git de terceros Cloud Storage.

Se superó la cuota de BigQuery

El siguiente error se produce cuando la cantidad de solicitudes a la API que que Dataform envía a BigQuery supera la cantidad de cuota:

Quota exceeded: Your user_method exceeded quota for concurrent api requests
per user per method.

Para resolver este error, reduce la cantidad de consultas paralelas a menos de 250 pulgadas de la siguiente manera:

Si deseas obtener instrucciones para resolver este error en BigQuery, consulta Solución de problemas cuota y límite errores.

Se superó el límite de simultaneidad de consultas de BigQuery

El siguiente error ocurre cuando se ejecuta la cantidad de consultas simultáneas en BigQuery supera la simultaneidad de consultas de BigQuery límite:

Exceeded rate limits: too many concurrent queries for this project_and_region

Para resolver este error, reduce la cantidad de consultas paralelas a menos de 250 pulgadas de la siguiente manera:

Si deseas obtener instrucciones para resolver este error en BigQuery, consulta Solución de problemas cuota y límite errores.

Errores de invocación del flujo de trabajo de BigQuery

Los siguientes errores ocurren durante la ejecución de un flujo de trabajo de SQL para BigQuery:

Para resolverlos, consulta Error de BigQuery mensajes.

Propiedades includeDependentAssertions en conflicto

El siguiente error ocurre durante la compilación cuando El parámetro includeDependentAssertions se estableció para la misma con diferentes valores en un mismo archivo:

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

Para resolver este error, edita el archivo y quita las repeticiones contradictorias del archivo Parámetro includeDependentAssertions.

Para obtener más información sobre el uso del parámetro includeDependentAssertions Para establecer aserciones como dependencias, consulta Configura las aserciones de una acción seleccionada como dependencias.

Falla la compilación

Se producen los siguientes errores durante la compilación debido al tamaño o la cantidad de compilaciones en la nube:

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

Para solucionar estos errores, sigue estos pasos:

  1. Actualiza el núcleo de Dataform a la versión más reciente versión.
  2. Inspecciona tu flujo de trabajo de SQL para identificar y reducir las ineficiencias.
  3. Reduce el tamaño de las consultas en SQL.
  4. Reduce la cantidad de operaciones de JavaScript en la memoria, por ejemplo:

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

Para obtener más información sobre los límites de recursos de compilación de Dataform, consulta Cuotas y límites

@dataform/core errores de dependencia

Los siguientes errores se producen durante la compilación si la dependencia dataform-core en package.json está desactualizado:

Failed to resolve @dataform/core
@dataform/core version should be X.X.X or newer

Se requiere la dependencia @dataform/core en package.json. Cuando inicializamos el primer espacio de trabajo en tu repositorio, Dataform automáticamente package.json con la versión actual de @dataform/core Debes actualizar @dataform/core a la última versión, como se muestra a continuación: cuando sale.

Para resolver estos errores, actualiza @dataform/core a la versión más reciente versión.

No se pudo resolver dataform.json

El siguiente error ocurre cuando inicializas un lugar de trabajo de Dataform. pero el proceso de inicialización no logra instalar todos los paquetes:

Uncaught Error: Failed to resolve dataform.json

Para resolver este error, abre package.json en tu lugar de trabajo y haz clic en Install packages.

No se pudo resolver workflow_settings.yaml

El siguiente error ocurre cuando inicializas un lugar de trabajo de Dataform. pero el proceso de inicialización no logra instalar todos los paquetes:

Uncaught Error: Failed to resolve workflow_settings.yaml

Para resolver este error, en tu lugar de trabajo, abre workflow_settings.yaml y Haz clic en Install packages.

No se admiten los destinos de paquete git+

El siguiente error ocurre cuando defines paquetes en package.json con destinos con el prefijo 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 no admite objetivos de paquetes con el prefijo git+.

Para resolver este error, genera una URL tar.gz del paquete y actualiza el el destino del paquete en package.json. Para obtener más información sobre la instalación de paquetes en Dataform, consulta Instala un paquete en Dataform.

Se agota el tiempo de espera de instalación del paquete

El siguiente error ocurre cuando el tamaño de los paquetes definidos en package.json. supera el tamaño máximo de la NPM dependencias:

API request error: Package installation timed out

Para resolver este error, quita los paquetes redundantes de package.json. Asegúrate de que el archivo package.json no contiene @dataform/cli y que el total el tamaño de las dependencias NPM definidas no supera los 200 MB.

Si tus configuraciones de lanzamiento consulta los comités de Git, asegúrate de que los archivos package.json en su objetivos son válidos.

No se puede acceder al registro de paquetes privado

El siguiente error ocurre cuando se autentica Dataform para un :

Permission denied when fetching one or more npm packages. Please verify that
private registry authentication details are valid for each npm registry

Para resolver este error, verifica que los detalles de autenticación del registro privado estén son válidos para cada registro de NPM. Para obtener más información, consulta Autentica un servicio en Dataform.

No se puede acceder al repositorio remoto

El siguiente error se produce por fragilidad de Git o cuando el nombre de una rama en la repositorio de Git externo conectado contiene una fuente carácter:

Remote repository REPOSITORY_NAME could not be reached.

Para resolver este error, inspecciona los nombres de las ramas en el tercero conectado en un repositorio de confianza. Si el nombre de una rama contiene un carácter que no es ASCII o no inglés, borrar la rama.

No se puede acceder al repositorio remoto: generic::invalid_argument

El siguiente error ocurre en la página Detalles de configuración de lanzamiento cuando se en la versión programada suele encontrarse un GitHub lento, inestable o descartado, Conexión de GitLab o Bitbucket:

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

No es necesario realizar ninguna acción. A menos que GitHub, GitLab o Bitbucket Cloud si los problemas persisten, las versiones programadas posteriores pueden tener éxito.

No se puede acceder al secreto de un repositorio remoto

El siguiente error se produce cuando tu cuenta de servicio de Dataform no puede acceder a tu Secret de Secret Manager de un tercero siguiente:

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.

Para resolver este error, haz lo siguiente:

  • Verifica que tu cuenta de servicio de Dataform tenga acceso al Secret.
  • Excluye el Secret del perímetro de servicio de VPC-SC. Dataform no es compatible con VPC-SC en este momento.