본문으로 건너뛰기
Structly 문서
English

stly

stly tables

이 페이지의 내용

이 페이지는 공개 계약에서 생성하며 설명은 원문(한국어) 그대로 표시합니다.

stly tables create#

Table 생성

  • HTTP 요청: POST /api/databases/{database_id}/tables
  • 인증 모드: Agent 토큰, User 세션
  • 기록 변경: 예
  • 입력 JSON(--input) 필수

입력 JSON 구조는 stly schema tables create로 확인합니다.

옵션

이름타입필수설명
--databasestring예부모 Database ID
--inputstring예JSON 원문 파일 또는 stdin(-)
--fieldsstring아니요응답 최상위 필드, 쉼표로 구분
값: created_at, database_id, definition, description, id, name, namespace, summary, updated_at

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly tables create --database 00000000-0000-0000-0000-000000000001 --input input.json

stly tables delete#

Table 삭제

  • HTTP 요청: DELETE /api/tables/{id}
  • 인증 모드: Agent 토큰, User 세션
  • 기록 변경: 예
  • --if-match 필수

인수

  • id: ID

옵션

이름타입필수설명
--if-matchstring예상세 GET에서 얻은 단일 strong ETag
--fieldsstring아니요응답 최상위 필드, 쉼표로 구분

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly tables delete 00000000-0000-0000-0000-000000000001 --if-match '"상세 GET의 ETag"'

stly tables get#

Table 상세 조회

  • HTTP 요청: GET /api/tables/{id}
  • 인증 모드: Agent 토큰, User 세션
  • 기록 변경: 아니요

인수

  • id: ID

옵션

이름타입필수설명
--fieldsstring아니요응답 최상위 필드, 쉼표로 구분
값: created_at, database_id, definition, description, id, name, namespace, summary, updated_at

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly tables get 00000000-0000-0000-0000-000000000001

stly tables list#

Table 목록 조회

  • HTTP 요청: GET /api/databases/{database_id}/tables
  • 인증 모드: Agent 토큰, User 세션
  • 기록 변경: 아니요

옵션

이름타입필수설명
--databasestring예부모 Database ID
--fieldsstring아니요응답 최상위 필드, 쉼표로 구분
값: created_at, database_id, definition, description, id, name, namespace, summary, updated_at

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly tables list --database 00000000-0000-0000-0000-000000000001

Table 연결 Service 집합 조회

  • HTTP 요청: GET /api/tables/{id}/service-links
  • 인증 모드: Agent 토큰, User 세션
  • 기록 변경: 아니요

인수

  • id: ID

옵션

이름타입필수설명
--fieldsstring아니요응답 최상위 필드, 쉼표로 구분
값: service_ids, table_id, updated_at

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly tables service-links get 00000000-0000-0000-0000-000000000001

Table 연결 Service 집합 전체 교체

  • HTTP 요청: PUT /api/tables/{id}/service-links
  • 인증 모드: Agent 토큰, User 세션
  • 기록 변경: 예
  • 입력 JSON(--input) 필수
  • --if-match 필수

입력 JSON 구조는 stly schema tables service-links update로 확인합니다.

인수

  • id: ID

옵션

이름타입필수설명
--if-matchstring예상세 GET에서 얻은 단일 strong ETag
--inputstring예JSON 원문 파일 또는 stdin(-)
--fieldsstring아니요응답 최상위 필드, 쉼표로 구분
값: service_ids, table_id, updated_at

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly tables service-links update 00000000-0000-0000-0000-000000000001 --input input.json --if-match '"상세 GET의 ETag"'

stly tables services#

Table의 직접 연결 Service 목록

  • HTTP 요청: GET /api/tables/{id}/services
  • 인증 모드: Agent 토큰, User 세션
  • 기록 변경: 아니요

인수

  • id: ID

옵션

이름타입필수설명
--fieldsstring아니요응답 최상위 필드, 쉼표로 구분
값: created_at, description, handle, id, name, status, summary, updated_at
--pagestring아니요1 이상 정수. page·per-page 중 하나라도 있으면 페이지 모드
--per-pagestring아니요1~500 정수, 생략 시 100
--qstring아니요name 필드의 대소문자 구분 리터럴 부분 일치 검색. summary·description·본문은 검색하지 않으며 정규식·와일드카드를 지원하지 않습니다
--sortstring아니요리소스 기본 필드명 또는 - 접두 역순만 허용

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly tables services 00000000-0000-0000-0000-000000000001 --q "검색어"

stly tables update#

Table 수정

  • HTTP 요청: PUT /api/tables/{id}
  • 인증 모드: Agent 토큰, User 세션
  • 기록 변경: 예
  • 입력 JSON(--input) 필수
  • --if-match 필수

입력 JSON 구조는 stly schema tables update로 확인합니다.

인수

  • id: ID

옵션

이름타입필수설명
--if-matchstring예상세 GET에서 얻은 단일 strong ETag
--inputstring예JSON 원문 파일 또는 stdin(-)
--fieldsstring아니요응답 최상위 필드, 쉼표로 구분
값: created_at, database_id, definition, description, id, name, namespace, summary, updated_at

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly tables update 00000000-0000-0000-0000-000000000001 --input input.json --if-match '"상세 GET의 ETag"'

stly tables validate#

관계형 Table 생성·수정 후보 사전 검증(저장 없음, 부모 이동 포함)

  • HTTP 요청: --operation create POST /api/databases/{database_id}/tables/validate, --operation update PUT /api/tables/{id}/validate
  • 인증 모드: Agent 토큰, User 세션
  • 기록 변경: 아니요
  • 입력 JSON(--input) 필수

입력 JSON 구조는 stly schema tables validate --operation create|update로 확인합니다.

인수

  • id: ID

옵션

이름타입필수설명
--inputstring예JSON 원문 파일 또는 stdin(-)
--operationstring예검증할 작업 종류. 생성 후보는 create, 수정 후보는 update
값: create, update
--databasestring아니요부모 Database ID
--fieldsstring아니요응답 최상위 필드, 쉼표로 구분
--if-matchstring아니요상세 GET에서 얻은 단일 strong ETag

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

동작

  1. 실제 서버를 호출해 입력·참조·중복·If-Match를 검사하며 저장하지 않습니다. 도메인 규칙은 서버가 판단합니다.
  2. --operation create: 대상 id·If-Match 금지. update: 대상 id·단일 strong If-Match 필수, 부모 옵션 금지
  3. --dry-run: credential 접근·HTTP 요청·파일 변경 없이 요청 계획만 출력
  4. 성공은 관찰 시점의 유효성으로 저장 성공·ID 예약·충돌 방지를 보장하지 않습니다. 자동 저장·자동 재시도하지 않습니다.
  5. 지원: 다섯 RDB engine. 생성은 --database 필수, 수정의 부모 이동은 본문 database_id

예시

stly tables validate --operation create --database 00000000-0000-0000-0000-000000000001 --input input.json
stly tables validate 00000000-0000-0000-0000-000000000001 --operation update --input input.json --if-match '"상세 GET의 ETag"'