Perfiles de columnas
Indica qué campos Name y String apuntan a otra tabla o cuándo un handle puede estar vacío.
Cuándo necesitas un perfil
Usa un perfil cuando una columna Name o String guarda la clave de una fila de otra tabla, o cuando un handle vacío es válido. Sin un mapeo, los campos Name y String normales no se tratan como claves externas.
Escribir y cargar un perfil
Un campo Name o String solo se convierte en relación cuando lo mapeas. Usa los nombres de propiedad de nivel superior. Una regla de handle anulable cambia el significado del valor vacío; su destino real sigue siendo la autoridad. En una regla para row handle, deja targetTablePath vacío porque el propio handle guarda su destino. El ejemplo siguiente mapea una propiedad Name o String llamada TargetKey.
{
"schemaVersion": 1,
"maxRecords": 10000,
"rules": [{
"tablePath": "/Game/Data/Consumers.Consumers",
"propertyPath": "TargetKey",
"targetTablePath": "/Game/RowTetherExample/Targets.Targets",
"nullable": true
}]
}
Los arrays y sets superiores de DataTableRowHandle sí se inspeccionan. Las referencias anidadas, los mapas, los arrays estáticos y los contenedores no compatibles se informan como omisiones y pueden producir cobertura Partial. Los campos Name arbitrarios nunca se infieren como claves externas.
Sobre schemaVersion
Mantén schemaVersion en 1 y valida las rutas antes de revisar. Un perfil inválido se informa como configuración incompleta; no se convierte silenciosamente en cobertura total.