콘텐츠로 이동

스키마 조회

스키마 조회 스킬은 데이터베이스의 테이블 목록, 컬럼 구조, 데이터베이스 목록을 확인합니다. DB 구조를 파악한 후 쿼리를 구성할 때 유용합니다.


설정 방법

1. 스킬 노드 추가 및 선택

스킬 노드를 추가하고 우측 패널에서 스키마 조회를 선택합니다.

스키마 조회 스킬 선택

2. Database 인증 연결

인증 탭에서 데이터베이스 인증 정보를 선택합니다. (DB 조회와 동일한 인증 사용 가능)

3. 파라미터 입력

설정 탭에서 조회 작업(list_tables, describe_table, list_databases)을 선택합니다.

스키마 조회 파라미터 입력 — operation, table 설정


파라미터

파라미터 필수 설명
operation O list_tables, describe_table, list_databases
table 테이블명 (describe_table 시 필수)

인증 정보

Database 인증이 필요합니다. (DB 조회와 동일)


출력

테이블 목록 (list_tables)

{
  "success": true,
  "data": {
    "tables": [
      {"name": "users", "columns": ["id", "name", "email"]},
      {"name": "orders", "columns": ["id", "user_id", "amount"]}
    ],
    "table_count": 2,
    "database": "mydb"
  }
}

테이블 상세 (describe_table)

{
  "success": true,
  "data": {
    "table": "users",
    "columns": [
      {"name": "id", "type": "INTEGER", "nullable": false, "key": "PRI", "default": null},
      {"name": "name", "type": "VARCHAR(100)", "nullable": false, "key": "", "default": null},
      {"name": "email", "type": "VARCHAR(255)", "nullable": true, "key": "UNI", "default": null}
    ],
    "column_count": 3
  }
}

사용 예시

AI 에이전트의 DB 구조 파악

워크플로우 예시 — 수동 트리거 → 스키마 조회 → AI 에이전트 → DB 조회

AI 에이전트에게 스키마 정보를 제공하면 정확한 SQL 쿼리를 생성할 수 있습니다.