# ฐานข้อมูลของ Site Code

> ตาราง MySQL ของเว็บคุณเอง — ฐานข้อมูลแยกที่แตะตาราง CMS ไม่ได้, migration, query builder, db.docs, view core_* และหน้าจัดการฐานข้อมูล

ที่มา: https://anasaki.live/docs/developers/database

Site Code มีตาราง MySQL ของตัวเอง ออกแบบด้วย **migration** และเรียกใช้ด้วย **query builder** แบบ synchronous จัดการข้อมูลได้ที่ **โค้ดของเว็บไซต์ → ฐานข้อมูล**

## ฐานข้อมูลแยก (แนะนำ)

```text
MySQL
├── anasaki        ตารางของ CMS — ผู้ใช้ของโค้ดไม่มีสิทธิ์ใด ๆ ที่นี่
└── anasaki_code   ตารางของนักพัฒนา + view core_* แบบอ่านอย่างเดียว
```

- โค้ดทั้งหมด (migration, `db.*`, SQL console) รันด้วยผู้ใช้ MySQL `anasaki_code` ซึ่งมีสิทธิ์เฉพาะฐานข้อมูล `anasaki_code` — MySQL เองจึงกันไม่ให้แตะตาราง CMS
- การติดตั้งด้วย docker compose สร้างให้อัตโนมัติตอนเริ่มครั้งแรก (`docker/mysql-init/10-site-code.sh` + `CODE_DB_PASSWORD`) และส่ง `CODE_DB_DSN` ให้ CMS
- เว็บที่ติดตั้งก่อนหน้านั้น: รัน SQL 4 บรรทัดที่หน้าฐานข้อมูลแสดง แล้วตั้ง `CODE_DB_PASSWORD` — ขั้นตอนเต็มอยู่ใน [อัปเดตเวอร์ชัน](/docs/studio/upgrade)

### View `core_*` (อ่านอย่างเดียว)

| view | คอลัมน์ |
| --- | --- |
| `core_posts` | `id, type, title, slug, status, excerpt, author_id, featured_media_id, published_at, created_at, updated_at` (เฉพาะที่เผยแพร่) |
| `core_terms` | `id, taxonomy, name, slug` |
| `core_post_terms` | `post_id, term_id` (ของโพสต์ที่เผยแพร่) |
| `core_users` | `id, name, email, role, status, created_at` (ไม่มีรหัสผ่านหรือ token) |

### โหมดสำรอง (fallback)

ถ้าไม่มี `CODE_DB_DSN` หรือเชื่อมต่อไม่ได้ ตารางของคุณจะอยู่ในฐานข้อมูล CMS โดยขึ้นต้นด้วย `sc_` (ระบบเติม/ตัดให้เอง) — migration, query builder, `db.docs` และหน้าจัดการยังใช้ได้ แต่ `db.query`, `db.raw`, `schema.raw`, SQL console และ view `core_*` ใช้ไม่ได้ (ใช้ `db.posts` แทน) การเปลี่ยนจากโหมดสำรองเป็นฐานข้อมูลแยกไม่ย้ายตาราง `sc_` เดิมให้ (ต้อง dump → import เอง)

## Migration

สร้างไฟล์ใน `migrations/` (ปุ่ม **Migration ใหม่** ใน editor ตั้งชื่อเป็น `migrations/NNN_ชื่อ.ts` ให้) รันตามลำดับชื่อไฟล์

```ts
// migrations/001_create_orders.ts
export default migration({
  up(schema) {
    schema.create('orders', (t) => {
      t.id();                                              // BIGINT UNSIGNED AUTO_INCREMENT PK
      t.string('code', 20).unique();
      t.foreignId('user_id').nullable().references('core_users');
      t.enum('status', ['pending', 'paid']).default('pending');
      t.decimal('total', 12, 2);
      t.json('shipping').nullable();
      t.timestamps();                                      // created_at, updated_at
      t.index(['status', 'created_at']);
    });
  },
  down(schema) { schema.drop('orders'); },
});
```

- คอลัมน์: `id, string, text, integer, bigInteger, decimal, boolean, date, datetime, json, enum, uuid, foreignId, timestamps()` · modifier: `nullable, default, unique, index, unsigned, comment, after, change, useCurrent, references(...).onDelete(...)` · ทำให้คอลัมน์แยกตัวพิมพ์ด้วย `.binary()`
- ชื่อตาราง `^[a-z][a-z0-9_]{0,62}$` ห้ามขึ้นต้น `core_`, `script_`, `sc_`, `bak_`
- **ตอนเผยแพร่** migration ที่ค้างรันก่อนโค้ดใหม่ขึ้นเว็บจริง ถ้าล้ม การเผยแพร่หยุดและโค้ดเดิมทำงานต่อ (DDL ของ MySQL ไม่อยู่ใน transaction — แก้ด้วย migration ใหม่ หรือแก้ไฟล์ที่ล้มแล้วเผยแพร่ใหม่)
- **การเปลี่ยนแปลงที่อาจทำให้ข้อมูลหาย** (drop / rename / เปลี่ยนชนิดคอลัมน์) ต้องติ๊กยืนยัน &#34;ฉันเข้าใจว่าข้อมูลอาจหายไป&#34; ระบบสำรองตารางเป็น `bak__` ไว้ 7 วันก่อนรัน
- ย้อน migration ของชุดล่าสุดได้ที่หน้าฐานข้อมูล (รัน `down()`)

## Query builder (ใน handler)

```ts
const page = db.from('orders as o')
  .leftJoin('core_users as u', 'u.id', 'o.user_id')
  .select('o.id', 'o.code', 'o.total', 'u.name as customer')
  .where('o.status', 'paid').where('o.total', '>', 100)
  .orderBy('o.created_at', 'desc')
  .paginate(1, 20);                                         // { items, total, page, perPage }

const id = db.table('orders').insert({ code: 'A1', total: 10 });
db.table('orders').where('id', id).update({ total: 12 });   // update/delete ต้องมี where() หรือ .all()
db.transaction((tx) => { tx.table('a').insert({}); tx.table('b').insert({}); }); // throw = rollback

const notes = db.docs('notes');                              // เก็บ JSON แบบ document
notes.insert({ title: 'x' });
notes.find({ where: { title: 'x' }, orderBy: '-createdAt' });
```

- ทุกค่าเป็น bound parameter (กัน SQL injection) — SQL ดิบใช้ `db.query(sql, params)` / `db.raw(...)` (เฉพาะฐานข้อมูลแยก)
- ผลลัพธ์: DECIMAL → string, DATETIME → ISO string, JSON → object
- ขีดจำกัด: 5 วินาทีต่อคำสั่ง, 10,000 แถว / 10 MB ต่อผลลัพธ์ (ใช้ `paginate` — ไม่เกิน 100 ต่อหน้า)
- `anasaki-code types` สร้าง type ของแถวจากตารางจริง (`OrdersRow`) ให้ `db.table('orders')` มี type

> [!WARNING]
> **ทดสอบ route** ใช้ฐานข้อมูลจริง — ข้อมูลที่โค้ดเขียนหรือลบระหว่างทดสอบจะเปลี่ยนจริง

## หน้า ฐานข้อมูล

| ทำอะไรได้ | สิทธิ์ |
| --- | --- |
| ดูตาราง โครงสร้าง ข้อมูล (ค้นหา กรอง เรียง) ส่งออก CSV/JSON, dump `.sql`, ประวัติ migration, ตารางสำรอง | `view_code_data` |
| SQL console แบบอ่าน (SELECT/SHOW/EXPLAIN… ใน transaction อ่านอย่างเดียว) | `view_code_data` |
| เพิ่ม/แก้/ลบแถว, นำเข้า CSV, SQL แบบเขียน, ลบตารางสำรอง | `edit_code_data` |
| ย้อน migration | `edit_code_data` + `publish_scripts` |

ใครเข้าถึงตารางผ่านหน้าออกแบบได้บ้างตั้งที่ **สิทธิ์การเข้าถึง** (ค่าเริ่มต้นของตาราง = ไม่มีใคร) ดู [ผูกข้อมูลกับหน้าออกแบบ](/docs/developers/designer-bindings)
