Zio.entity()
PostgreSQL usr 스키마의 표를 다룹니다. 표를 세우고 없애는 것까지 되지만 칸 구성은 못 바꿉니다 — 그것이 되는 것은 Zio.code 뿐입니다. 넷을 견주어 보려면 Zio.Database (개요) 의 표를 보십시오.
커스텀 테이블 API
섹션 제목: “커스텀 테이블 API”PostgreSQL의 usr 격리 스키마 내에 테이블을 동적 생성하고(DDL), 보안 처리(SQL Injection 방어)가 적용된 CRUD 연동(DML)을 Fluent API 체이닝 형태로 처리할 수 있습니다.
| Method | Description |
|---|---|
Zio.entity(table_name) |
PostgreSQL 테이블 및 뷰 조작을 위한 Fluent API 체이닝의 시작점입니다. |
.create_table(columns, display_name, description) |
컬럼 정보 리스트(name, type, pk, nullable 등)를 받아 테이블 및 시스템 메타데이터를 선제 생성합니다. 같은 이름이 이미 있으면 거절합니다 — 지우고 다시 만들려면 아래 .drop_table() 을 먼저 부르십시오. |
.drop_table(force=False) |
표를 통째로 지웁니다. **되돌릴 수 없습니다.**행이 하나라도 남아 있으면 거절하고 몇 행인지 알려 줍니다 — 잘못 만든 빈 표를 치우는 일과, 사람이 채워 온 대장을 날리는 일은 다르기 때문입니다. 그래도 지우려면 force=True 를 주십시오. Zio.raw("DROP TABLE …") 는 막혀 있습니다 — 그쪽은 usr 스키마 밖으로도 나갈 수 있었습니다. |
.add_column(column) |
칸 하나를 뒤에 더합니다. {name, type, nullable, default, desc} — create_table 의 칸 한 줄과 같은 꼴입니다. 이미 든 행은 그 칸이 빈 채로 남습니다. 기본키는 나중에 붙일 수 없고, nullable: False 면 default 가 있어야 합니다 (이미 든 행을 무엇으로 채울지 정해야 하므로). (예: Zio.entity("teacher").add_column({"name": "memo", "type": "Text"})) |
.rename_column(old_name, new_name) |
칸 이름을 바꿉니다. 든 값도 함께 옮겨 갑니다 — 지워지지 않습니다. |
.drop_column(column_name, force=False) |
칸 하나를 뺍니다. 그 칸의 값만 사라지고 다른 칸과 행은 그대로입니다. 되돌릴 수 없습니다. 값이 든 행이 하나라도 있으면 거절하고 몇 행인지 알려 줍니다 — drop_table 과 같은 규칙입니다. 그래도 빼려면 force=True 를 주십시오. |
.create(props) |
테이블에 새로운 데이터 행을 삽입(INSERT)합니다. |
.where(**kwargs) |
조건절(Filters)을 지정합니다. (예: id=1, source_file__contains="manual" 등) |
.where_or(**kwargs) |
같은 표의 여러 조건을 OR 로 묶습니다(다른 .where() 와는 AND). 키워드 검색처럼 여러 칸 중 하나라도 맞으면 될 때 씁니다 — 예전엔 질의를 여러 번 나눠 파이썬에서 합쳐야 했습니다. 접미사(__contains 등)는 .where() 와 같습니다. 여러 번 부르면 각 호출이 별개의 OR 덩어리가 되어 서로 AND 로 이어집니다. fetch()·count()(읽기)에만 걸립니다 — update()·delete() 에 OR 을 걸면 의도보다 많은 행을 건드릴 수 있어 받지 않습니다. (예: .where_or(title__contains=kw, body__contains=kw)) |
.columns(*names) |
fetch() 에서 돌려받을 컬럼만 고릅니다. 안 주면 전체(SELECT *). 필요한 칸만 읽어 메모리·속도를 아낍니다 — 무거운 칸(예: 패스워드 해시)을 안 끌어옵니다. (예: Zio.entity("users").columns("user_name", "aliases").fetch()) |
.update(props) |
조건절(where)에 부합하는 데이터 행을 수정(UPDATE)합니다. |
.delete() |
조건절(where)에 부합하는 데이터 행을 삭제(DELETE)합니다. |
.fetch() |
조건절(where)에 부합하는 데이터를 조회(SELECT)하여 GraphResult로 가져옵니다. |
커스텀 테이블 Fluent CRUD 실전 예제
섹션 제목: “커스텀 테이블 Fluent CRUD 실전 예제”from zio_ontology import Zio
# 1. 테이블 선제 생성 (DDL)def initialize_database(): columns = [ {"name": "id", "type": "Integer", "pk": True}, {"name": "source_file", "type": "String", "nullable": True}, {"name": "content", "type": "Text", "nullable": True} ] # usr."test_manual" 테이블 생성 및 메타데이터 자동 등록 Zio.entity("test_manual").create_table(columns=columns, display_name="테스트 매뉴얼")
# 2. CRUD 시나리오 수행 (DML)def run_db_operations(): # 데이터 삽입 (Create) new_row = Zio.entity("test_manual").create({ "source_file": "manual_v1.pdf", "content": "사출성형 온도 관리 수칙..." }).data # 데이터 수정 (Update) Zio.entity("test_manual").where(source_file="manual_v1.pdf").update({ "content": "사출성형 온도 및 압력 관리 수칙..." }) # 데이터 조회 (Fetch) results = Zio.entity("test_manual").where(source_file__contains="manual").fetch().data print(results) # 데이터 삭제 (Delete) Zio.entity("test_manual").where(id=1).delete()만든 표를 수집 파이프라인으로 — 사용자 정의 DB(usr_db)
섹션 제목: “만든 표를 수집 파이프라인으로 — 사용자 정의 DB(usr_db)”Zio.entity() 로 쌓은 표·뷰를 수집 파이프라인에 태우면 다른 수집 데이터처럼 정형화·점수 매기기·온톨로지 흐름을 탑니다. 수집 대상 종류 중 「사용자 정의 DB」(usr_db) 가 그 길입니다. ODBC 와 달리 접속 정보가 없습니다 — 엔진이 읽기 전용으로 usr 안만 읽습니다.
- 연결을 등록합니다. 화면(Pipeline Builder → 사용자 정의 DB)에서 해도 되고, SDK 로는 기초코드 표
usr_db에 행을 넣습니다(아래 예). - 수집 스키마와 기본키를 정합니다 — Pipeline Builder 에서 「데이터 소스로부터 스키마 분석」 → 「수집스키마 저장」 → 기본키 칸(예:
id) 지정. 스키마 이름은 처음 만들 때 연결명을 따릅니다. 기본키가 없으면 돌릴 때마다 같은 행이 또 쌓입니다. - 수집된 것을 읽습니다 —
Zio.ingestion("신용카드승인데이터")(스키마 이름으로).
from zio_ontology import Zio
# 1. 연결 등록 — 기초코드 표 usr_db 에 행 하나Zio.code("usr_db").create({ "conn_name": "신용카드승인데이터", "query": "SELECT * FROM card_expense_records WHERE use_date >= '@getDate()' LIMIT 100", "use_yn": "Y",})query 의 규칙 — SELECT 만 됩니다(WITH … SELECT 포함). usr. 는 붙여도 안 붙여도 됩니다(FROM card_expense_records = usr.card_expense_records). public.·pg_…·information_schema. 를 이름으로 찍으면 거절합니다. 예약어(@getDate()·@getDateTime(), 대소문자 무관)는 따옴표로 감쌉니다 — 감싸지 않으면 2026-10-17 이 뺄셈으로 읽힙니다. 읽는 양은 SELECT 가 정하므로 처음엔 LIMIT 을 두십시오. 중복은 수집 스키마의 기본키로 거르고, 이미 가져온 행은 내용이 바뀌어도 다시 오지 않습니다.
칸 바꾸기는 DataStudio 화면과 같은 규칙입니다
섹션 제목: “칸 바꾸기는 DataStudio 화면과 같은 규칙입니다”
add_column·rename_column·drop_column은 DataStudio 화면에서 표를 고쳐 저장할 때와 같은 함수를 지납니다 — 실제 표·칸 설명·등록부가 한 번에 바뀌고, 하나라도 실패하면 전부 되돌아갑니다. 표를 새로 만들고 값을 옮길 필요가 없습니다.
(주)지오유 · 경기 용인시 처인구 유림로154번길(유방동 673-2) 20-13
대표자 신달수·사업자등록번호 142-81-36612·통신판매업 신고번호 용인처인-0118호·개인정보 관리책임자 신달수·전자우편 shindalsoo@gmail.com·전화 1833-3623·팩스 02-6918-4006