콘텐츠로 이동

Zio.entity()

PostgreSQL usr 스키마의 표를 다룹니다. 표를 세우고 없애는 것까지 되지만 칸 구성은 못 바꿉니다 — 그것이 되는 것은 Zio.code 뿐입니다. 넷을 견주어 보려면 Zio.Database (개요) 의 표를 보십시오.

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 안만 읽습니다.

  1. 연결을 등록합니다. 화면(Pipeline Builder → 사용자 정의 DB)에서 해도 되고, SDK 로는 기초코드 표 usr_db 에 행을 넣습니다(아래 예).
  2. 수집 스키마와 기본키를 정합니다 — Pipeline Builder 에서 「데이터 소스로부터 스키마 분석」 → 「수집스키마 저장」 → 기본키 칸(예: id) 지정. 스키마 이름은 처음 만들 때 연결명을 따릅니다. 기본키가 없으면 돌릴 때마다 같은 행이 또 쌓입니다.
  3. 수집된 것을 읽습니다 — 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