SuiteQL Metadata vs SuiteCloud XML
Choose SuiteQL analytics metadata or SuiteCloud SDF XML for custom-record field definitions—and avoid treating them as interchangeable schemas.
Metadata
2 notes in this thread.
NetSuite Custom Field Metadata Tables
Map NetSuite custom-field families to SuiteQL metadata records, clarify definition versus instance data, and use the Records Catalog as the source of truth.