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.