Pular para o conteúdo principal

Parameter defaults

ContractForge mantém os contratos concisos, mas os padrões não podem ocultar a ingestão semântica. Um valor pode ser padronizado apenas quando omiti-lo não altera a gravação comportamento, risco de perda de dados, intenção de governança, postura de custos ou confiança na implantação limites.

Padrões principais seguros

FieldDefaultPor que
layerbronzeMissing layer means first ingestion layer.
modeappendComportamento de escrita conservador; nenhuma substituição, mesclagem ou histórico está implícito.
schema_policypermissiveComportamento permissivo existente; políticas estritas/aditivas permanecem explícitas.
on_quality_failfailA qualidade permanece fechada a menos que um aviso/quarentena seja solicitado.
hash_strategyexplicitAvoids hashing hundreds of columns by accident.
idempotency_policyalways_runNão ignora silenciosamente as execuções solicitadas.
source.state.storageadapter_managedO adaptador usa seu estado nativo mais seguro quando nenhum estado externo é declarado.
environment.namedevSomente rótulo lógico; não altera a semântica de ingestão.
schedule.timezoneUTCPadrão do agendador portátil quando um agendamento é declarado.

Padrões do adaptador

Os adaptadores podem padronizar botões de tempo de execução nativos quando documentados.

AdaptadorFieldDefault
Databrickscatálogo/esquema de evidênciasmain.ops quando nenhum ambiente é fornecido.
Databricksworkspace path/Workspace/ContractForge.
Databricksalvo do pacoteenvironment name, defaulting to dev.
AWSGlue version4.0.
AWSworker typeG.1X.
AWSworkers2.
AWStimeout60 minutes.
AWSretries0.
AWSmodo de execuçãolibrary_runner.
AWSjob bookmarksInferido da semântica de origem, a menos que seja explicitamente configurado.

Deve permanecer explícito

Não infira estes valores:

  • substituições específicas de local de origem, tabela, consulta, endpoint e conjunto de dados;
  • nome da tabela de destino;
  • modos de gravação sem acréscimo;
  • chaves de mesclagem, chaves SCD e política de coluna hash;
  • regras de qualidade e política de aplicação da qualidade;
  • concessões de acesso, filtros de linha e máscaras;
  • proprietário, SLA, criticidade e metadados de runbook;
  • seletor de adaptador em um arquivo de ambiente;
  • Artefato AWS URI, armazém Iceberg, função Glue ARN e localização da roda;
  • Identificadores de espaço de trabalho/perfil/cluster/armazém Databricks quando necessário;
  • segredos e credenciais.

Generated projects

O YAML gerado deve omitir os botões do adaptador que já possuem adaptador documentado padrões. Para AWS, o ambiente gerado mantém apenas implantação não inferível limites como artefato URI, armazém Iceberg, caminho da roda e função Glue ARN. Tamanho do trabalhador, contagem de trabalhadores, tempo limite, novas tentativas e configurações de marcadores são omitidos, a menos que o usuário os solicite.