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
| Field | Default | Por que |
|---|---|---|
layer | bronze | Missing layer means first ingestion layer. |
mode | append | Comportamento de escrita conservador; nenhuma substituição, mesclagem ou histórico está implícito. |
schema_policy | permissive | Comportamento permissivo existente; políticas estritas/aditivas permanecem explícitas. |
on_quality_fail | fail | A qualidade permanece fechada a menos que um aviso/quarentena seja solicitado. |
hash_strategy | explicit | Avoids hashing hundreds of columns by accident. |
idempotency_policy | always_run | Não ignora silenciosamente as execuções solicitadas. |
source.state.storage | adapter_managed | O adaptador usa seu estado nativo mais seguro quando nenhum estado externo é declarado. |
environment.name | dev | Somente rótulo lógico; não altera a semântica de ingestão. |
schedule.timezone | UTC | Padrã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.
| Adaptador | Field | Default |
|---|---|---|
| Databricks | catálogo/esquema de evidências | main.ops quando nenhum ambiente é fornecido. |
| Databricks | workspace path | /Workspace/ContractForge. |
| Databricks | alvo do pacote | environment name, defaulting to dev. |
| AWS | Glue version | 4.0. |
| AWS | worker type | G.1X. |
| AWS | workers | 2. |
| AWS | timeout | 60 minutes. |
| AWS | retries | 0. |
| AWS | modo de execução | library_runner. |
| AWS | job bookmarks | Inferido 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.