refactor: remove text from core types, keep as native passthrough

[dimitri-yatsenko]

Summary

Removes text from core DataJoint types. It remains available as a native SQL passthrough type (with portability warning).

Rationale

Core types should encourage structured, bounded data:

Need	Better Alternative
Bounded strings	varchar(n) with explicit limit
Structured text	json
Large text files	<object>
Notes/descriptions	varchar(4000) typically sufficient

Problems with text as a core type:

• No size constraint = unpredictable storage
• Behavior varies across MySQL/PostgreSQL
• Encourages dumping unstructured data
• Hurts query performance with unbounded fields

Changes

declare.py:

• Remove text from CORE_TYPES
• Update NATIVE_TEXT pattern: r"(tiny|small|medium|long)?text$" (now includes plain text)

Documentation:

• Update archive docs to note text is native-only
• Add guidance on alternatives (varchar, json, object)

Migration

Users who need text can:

# Option 1: Bounded varchar (preferred)
notes : varchar(4000)

# Option 2: JSON for structured content  
config : json

# Option 3: Object storage for large text
document : <object>

# Option 4: Native text (with warning)
description : text  # Works but shows portability warning

Related

• Inclusion of the TEXT MySQL Type #1194 (TEXT MySQL type request) - Addressed by keeping text as native passthrough

🤖 Generated with Claude Code