Tables API

데이터베이스 테이블과 스키마를 관리합니다.

GET/organizations/:orgId/databases/:dbId/tables

데이터베이스의 모든 테이블과 컬럼 정의를 조회합니다.

응답

{
  "tables": [
    {
      "name": "users",
      "comment": "User profiles",
      "columns": [
        { "name": "id", "type": "integer", "nullable": false, "unique": true, "default": null, "comment": null },
        { "name": "email", "type": "string", "nullable": false, "unique": true, "default": null, "comment": "User email" },
        { "name": "name", "type": "string", "nullable": true, "unique": false, "default": null, "comment": null },
        { "name": "created_at", "type": "date", "nullable": false, "unique": false, "default": "CURRENT_TIMESTAMP", "comment": null },
        { "name": "updated_at", "type": "date", "nullable": false, "unique": false, "default": "CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP", "comment": null }
      ]
    }
  ]
}

id, created_at, updated_at은 자동으로 관리됩니다. 응답에는 포함되지만 생성 또는 수정 요청에서는 지정할 수 없습니다.

POST/organizations/:orgId/databases/:dbId/tables

새 테이블을 생성합니다. id, created_at, updated_at 컬럼은 자동으로 추가됩니다.

Request body

{
  "name": "users",
  "comment": "User profiles",
  "columns": [
    { "name": "email", "type": "string", "nullable": false, "unique": true, "comment": "User email" },
    { "name": "name", "type": "string", "comment": "Display name" },
    { "name": "age", "type": "integer", "nullable": true },
    { "name": "active", "type": "boolean", "default": true, "comment": "Account status" }
  ]
}

응답

{
  "table": {
    "name": "users",
    "comment": "User profiles",
    "columns": [
      { "name": "id", "type": "integer", "nullable": false, "unique": true, "default": null, "comment": null },
      { "name": "email", "type": "string", "nullable": false, "unique": true, "default": null, "comment": "User email" },
      { "name": "name", "type": "string", "nullable": true, "unique": false, "default": null, "comment": "Display name" },
      { "name": "age", "type": "integer", "nullable": true, "unique": false, "default": null, "comment": null },
      { "name": "active", "type": "boolean", "nullable": true, "unique": false, "default": true, "comment": "Account status" },
      { "name": "created_at", "type": "date", "nullable": false, "unique": false, "default": "CURRENT_TIMESTAMP", "comment": null },
      { "name": "updated_at", "type": "date", "nullable": false, "unique": false, "default": "CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP", "comment": null }
    ]
  }
}

Column types: string, text, integer, float, boolean, date, json

Options: nullable (default: true), unique (default: false), default (default value), comment (column description). Note: text and json types do not support unique or default. The date type supports CURRENT_TIMESTAMP or CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP as default.

PUT/organizations/:orgId/databases/:dbId/tables/:tableName

기존 테이블을 수정합니다. 컬럼 추가, 이름 변경, 수정, 삭제, 순서 변경을 지원합니다.

Request body

{
  "add": [
    { "name": "phone", "type": "string", "nullable": true, "comment": "Phone number" }
  ],
  "rename": [
    { "from": "name", "to": "full_name" }
  ],
  "drop": ["age"],
  "comment": "Updated user profiles"
}

응답

{
  "table": {
    "name": "users",
    "comment": "Updated user profiles",
    "columns": [
      { "name": "id", "type": "integer", "nullable": false, "unique": true, "default": null, "comment": null },
      { "name": "email", "type": "string", "nullable": false, "unique": true, "default": null, "comment": "User email" },
      { "name": "full_name", "type": "string", "nullable": true, "unique": false, "default": null, "comment": null },
      { "name": "active", "type": "boolean", "nullable": true, "unique": false, "default": true, "comment": null },
      { "name": "phone", "type": "string", "nullable": true, "unique": false, "default": null, "comment": "Phone number" },
      { "name": "created_at", "type": "date", "nullable": false, "unique": false, "default": "CURRENT_TIMESTAMP", "comment": null },
      { "name": "updated_at", "type": "date", "nullable": false, "unique": false, "default": "CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP", "comment": null }
    ]
  }
}

DELETE/organizations/:orgId/databases/:dbId/tables/:tableName

테이블과 그 안의 모든 데이터를 삭제합니다. 이 작업은 되돌릴 수 없습니다.

응답

{
  "table": "users"
}

테이블을 삭제하면 모든 데이터가 영구적으로 삭제됩니다. 이 작업은 취소할 수 없습니다.