Pearlify UI

Pearlify Data Viewer

read-only

· 스키마

스키마

수집·저장되는 모든 표의 구조입니다. 데이터가 흐르는 계층(원본 → 정제 → 식별자)으로 묶었고, 화면에 직접 노출하지 않는 내부 표도 포함합니다.

원본 · 운영 6개 표

외부에서 받아온 그대로. 고치지 않고 쌓기만 합니다.

원본 기록RawRecord

raw_records

수집한 원본 그대로. 덧붙이기만 하고 절대 고치지 않는 진실의 원천입니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
capturePolicy열거형보존 정책
refKey문자열재취득 키기술
objectRefJSON저장 위치기술
checksum문자열체크섬기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시

재시도 큐IngestRetry

ingest_retries

가져오기·변환에 실패해 다시 시도할 항목. 오류 메시지는 키가 섞일 수 있어 조회되지 않습니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키
stubJSON재시도 입력기술
attempts정수시도 횟수
lastError문자열마지막 오류비밀
nextAttemptAt일시다음 시도
dead참/거짓포기됨
createdAt일시생성일시기술
updatedAt일시수정일시기술

미해석 회사명UnresolvedCompany

unresolved_companies

기사에서 뽑았지만 KRX 종목으로 못 이은 이름. 빈도순으로 보면 별칭 보강 대상이고, 대부분은 실제 비상장사입니다.

컬럼타입설명역할
id문자열ID기술
nameKey문자열정규화 키기술
name문자열회사명
hitCount정수언급 횟수
sampleArticleId문자열예시 기사기술
firstSeenAt일시최초 관측
lastSeenAt일시최근 관측

LLM 사용량LlmUsage

llm_usage

LLM 호출 한 건마다의 토큰·지연·배치 크기. 비용 추적용이라 비밀값이 없어 전부 조회됩니다.

컬럼타입설명역할
id문자열ID기술
provider문자열제공자
model문자열모델
purpose문자열용도
requestId문자열요청 ID기술
articleCount정수기사 수
inputTokens정수입력 토큰
outputTokens정수출력 토큰
totalTokens정수총 토큰
cachedInputTokens정수캐시 입력
latencyMs정수지연(ms)
state문자열상태
error문자열오류기술
createdAt일시호출일시

수집 상태SourceState

source_state

소스별 진행 위치와 토큰. 값 컬럼은 실제 인증 토큰이 들어 있어 조회되지 않습니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
key문자열
value문자열비밀
expiresAt일시만료일시
updatedAt일시수정일시

원본 바이트BlobObject

blob_objects

Postgres 안에 보관한 원본 파일 내용입니다.

컬럼타입설명역할
key문자열
data바이너리원본 바이트
metaJSON메타기술
createdAt일시생성일시

정제 데이터 15개 표

원본에서 뽑아 정리한 데이터. 언제든 원본에서 다시 만들 수 있습니다.

시그널

시그널Signal

signals

정제 데이터에서 유도한 구조화 시그널 — 무슨 일·어느 사업부·방향·중요도·근거. 소비 API(/v1/*)의 공통 엔벨로프. 지금은 원자재 급변(spike)만 유도합니다.

컬럼타입설명역할
id문자열ID기술
source문자열유도기
sourceRecordId문자열유도 키기술
domain문자열도메인
eventType문자열이벤트 유형
entityId문자열법인
krxCode문자열종목코드기술
seriesCode문자열원자재 시리즈
summary문자열요약
direction문자열방향
importanceLevel문자열중요도
importanceReason문자열중요도 근거기술
rationale문자열근거
businessUnit문자열사업부
metricsJSON지표기술
sourceName문자열출처기술
sourceUrl문자열출처 링크기술
sourceDocId문자열출처 문서기술
observedAt일시발생값
observedDate일시피드 기준일
observedAtPrecision문자열시간 정밀도기술
observedAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
revisedAt일시수정일시기술
derivedAt일시유도일시기술

주식

종목 변동 이벤트SecurityChangeEvent

security_change_events

상장종목 기준정보가 바뀐 순간 — 시장이전·종목명·ISIN 변경. 최신만 유지하는 기준표가 놓치는 이력을 raw 스냅샷 비교로 유도합니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
krxCode문자열종목코드
entityId문자열법인
changeType문자열변동 유형
fromValue문자열이전 값
toValue문자열이후 값
effectiveDate일시적용일
detectedAt일시감지일시기술

기업 행동CorporateAction

corporate_actions

배당·액면분할·상장폐지 등. 주가 그래프의 의미를 바꾸므로 가격과 따로 둡니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
subjectRefJSON원시 식별자기술
entityId문자열법인
actionType문자열행동 종류
announcementTime일시공표일시
exDate일시권리락일
recordDate일시기준일
paymentDate일시지급일
cashAmount소수주당 배당금
splitRatio소수분할 비율
currency문자열통화
adjustmentFactor소수조정 계수기술
detailJSON상세기술

시세 (OHLCV)MarketBar

market_bars

시가·고가·저가·종가. '가격 기준'이 원본인지 수정주가인지 구분합니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
subjectRefJSON원시 식별자기술
entityId문자열법인
intervalType문자열주기
tsStart일시기준시각
priceBasis문자열가격 기준
open소수시가
high소수고가
low소수저가
close소수종가
volume큰 정수거래량

재무제표 주요계정FundamentalFact

fundamental_facts

보고서별 핵심 계정(매출·이익·자산 등). 계정명은 공시 원문 그대로, 지표는 규칙으로 매핑합니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
subjectRefJSON원시 식별자기술
entityId문자열법인
corpCode문자열DART 코드기술
corpName문자열회사명
fiscalYear정수사업연도
fiscalPeriod문자열기간
consolidation문자열연결구분
statement문자열재무제표
accountName문자열계정명
metric문자열표준 지표
amount큰 정수금액
currency문자열통화기술
periodEnd일시기준일
rceptNo문자열접수번호기술

상장종목 스냅샷ListedSecurityInfo

listed_security_infos

금융위 KRX 상장종목정보. ISIN·시장구분·법인등록번호로 식별자 체계를 살찌웁니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
subjectRefJSON원시 식별자기술
entityId문자열법인
basDt일시기준일
srtnCd문자열단축코드(원본)기술
krxCode문자열종목코드
isinCd문자열ISIN
mrktCtg문자열시장
itmsNm문자열종목명
crno문자열법인등록번호기술
corpNm문자열법인명

시세 스냅샷 (시총·주식수)StockPriceSnapshot

stock_price_snapshots

금융위 주식시세정보. 종목 카드의 헤드라인 — 시가총액·상장주식수와 공식 일봉.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
subjectRefJSON원시 식별자기술
entityId문자열법인
basDt일시기준일
srtnCd문자열단축코드(원본)기술
krxCode문자열종목코드
isinCd문자열ISIN기술
itmsNm문자열종목명
mrktCtg문자열시장
clpr정수종가
vs정수대비
fltRt소수등락률
mkp정수시가기술
hipr정수고가기술
lopr정수저가기술
trqu큰 정수거래량
trPrc큰 정수거래대금기술
lstgStCnt큰 정수상장주식수
mrktTotAmt큰 정수시가총액

뉴스

뉴스 기사NewsArticle

news_articles

RSS로 수집한 기사. 원문이 사라질 수 있어 통째로 보관합니다. LLM 분석(경제뉴스 분류·요약)이 같은 행에 함께 보입니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
title문자열제목
url문자열링크
publisher문자열언론사
body문자열본문
isEconomic참/거짓경제뉴스접힘
category문자열분류접힘
relevance소수관련도접힘
summary문자열요약접힘
modelId문자열모델접힘기술
promptVersion정수프롬프트버전접힘기술
enrichedAt일시분석일시접힘기술

NewsEnrichment(news_enrichment)의 분석 컬럼을 같은 행에 접어서 함께 보여줍니다.

뉴스 분석NewsEnrichment내부

news_enrichment

기사를 LLM으로 경제뉴스 분류 + 요약한 파생 데이터. 뉴스 기사 화면에 함께 표시됩니다. 프롬프트 버전을 올려 재생성할 수 있습니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
articleId문자열기사기술
isEconomic참/거짓경제뉴스
category문자열분류
relevance소수관련도
summary문자열요약
modelId문자열모델
promptVersion정수프롬프트버전기술
enrichedAt일시분석일시

공시

지분 공시OwnershipDisclosure

ownership_disclosures

DART 지분 변동 공시. 누가 어느 회사 지분을 얼마나 갖고 움직였는지.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
corpCode문자열DART 고유번호기술
corpName문자열회사
holderName문자열보유자
kind문자열공시 종류
holdingShares큰 정수보유 주식수
holdingRatio소수지분율
changeShares큰 정수변동 주식수
changeRatio소수변동 지분율
detailJSON상세기술
subjectRefJSON원시 식별자기술
entityId문자열법인

자기주식TreasuryStockAction

treasury_stock_actions

회사가 자기 주식을 사거나 신탁계약을 맺은 내역입니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
corpCode문자열DART 고유번호기술
corpName문자열회사
stockCode문자열종목코드
kind문자열종류
amount큰 정수금액
startDate일시시작일
endDate일시종료일
detailJSON상세기술
subjectRefJSON원시 식별자기술
entityId문자열법인

원자재

원자재 가격CommodityPrice

commodity_prices

모든 원자재가 한 테이블(시리즈 코드로 식별): 국제 — 원유 WTI·천연가스(일간, FRED)·에너지 10종(EIA)·구리·금(월간, Pink Sheet)·리튬(월간, IMF PCPS); 국내(KRW, `-krx`) — 금(원/g)·석유 유종별(원/L)·배출권 KAU 계약별(원/톤), 금융위 일반상품시세 일간. 국내 원본 OHLCV는 원본(raw)에 보존됩니다. 상품이라 회사 번호표 대상이 아닙니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
seriesCode문자열시리즈 코드
seriesName문자열품목
unit문자열단위
frequency문자열주기
period문자열기간(원문)기술
periodDate일시기준일
value소수가격

지수·ETF

지수 시세MarketIndexSnapshot

market_index_snapshots

금융위 지수시세정보 — KOSPI·KOSDAQ 및 섹터 주가지수 일일 시세 (하루 ~170개 지수). 종목 카드의 '시장 대비' 맥락 재료입니다.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
basDt일시기준일
idxNm문자열지수명
idxCsf문자열분류
epyItmsCnt정수채용종목수기술
clpr소수종가
vs소수대비
fltRt소수등락률
mkp소수시가기술
hipr소수고가기술
lopr소수저가기술
trqu큰 정수거래량기술
trPrc큰 정수거래대금기술
lstgMrktTotAmt큰 정수상장시가총액
yrWRcrdHgst소수52주 최고기술
yrWRcrdHgstDt일시52주 최고일기술
yrWRcrdLwst소수52주 최저기술
yrWRcrdLwstDt일시52주 최저일기술

ETF 시세SecuritiesProductSnapshot

securities_product_snapshots

금융위 증권상품시세정보 — 전 상장 ETF 일일 시세 (하루 ~1,160종목, NAV·기초지수 포함 → 괴리율 파생 가능). ETN·ELW는 확장 예정.

컬럼타입설명역할
id문자열ID기술
source문자열수집원
sourceRecordId문자열원본 키기술
occurredAt일시발생값
occurredAtPrecision문자열시간 정밀도기술
occurredAtKind문자열시간 의미기술
availableAt일시관측 가능 시각
ingestedAt일시적재일시기술
rawId문자열원본 레코드기술
parserVersion정수파서 버전기술
productType문자열상품유형기술
basDt일시기준일
srtnCd문자열단축코드기술
isinCd문자열ISIN기술
itmsNm문자열종목명
clpr정수종가
vs정수대비
fltRt소수등락률
nav소수NAV
mkp정수시가기술
hipr정수고가기술
lopr정수저가기술
trqu큰 정수거래량
trPrc큰 정수거래대금기술
mrktTotAmt큰 정수시가총액
stLstgCnt큰 정수상장증권수기술
bssIdxIdxNm문자열기초지수
bssIdxClpr소수기초지수 종가기술
nPptTotAmt큰 정수순자산총액기술

연결

콘텐츠 연결ContentLink내부

content_links

뉴스↔회사, 뉴스↔원자재, 원자재↔회사 간선(파생). 무엇을 클릭해도 관련 콘텐츠를 보여주기 위한 매핑 — backfill:links로 언제든 재유도됩니다. 회사 키는 종목코드(krx_code).

컬럼타입설명역할
id문자열ID기술
fromType문자열출발 유형
fromId문자열출발 ID
toType문자열도착 유형
toId문자열도착 ID
linkType문자열연결 종류
confidence소수신뢰도
evidenceJSON근거기술
taggerVersion정수태거 버전기술
derivedAt일시유도일시기술

식별자 체계 5개 표

흩어진 식별자를 한 회사로 묶는 기준표.

법인LegalEntity

legal_entities

회사 그 자체. 가격과 공시가 만나는 기준점입니다.

컬럼타입설명역할
id문자열ID기술
canonicalName문자열회사명
legalName문자열법인명
countryCode문자열국가
entityType문자열유형
status문자열상태
validFrom일시유효 시작
validTo일시유효 종료
createdAt일시생성일시기술

증권Instrument

instruments

법인이 발행한 보통주·우선주·ETF 같은 금융상품입니다.

컬럼타입설명역할
id문자열ID기술
issuerEntityId문자열발행 법인
assetClass문자열자산군
instrumentType문자열증권 종류
currency문자열통화
status문자열상태
validFrom일시유효 시작
validTo일시유효 종료

상장 종목Listing

listings

특정 거래소에서 특정 종목코드로 거래되는 단위. 종목코드는 바뀔 수 있습니다.

컬럼타입설명역할
id문자열ID기술
instrumentId문자열증권
venueId문자열거래소
ticker문자열종목코드
status문자열상태
listingDate일시상장일
delistingDate일시상장폐지일
validFrom일시유효 시작기술
validTo일시유효 종료기술

거래소Venue

venues

한국거래소(XKRX), 나스닥(XNAS) 같은 거래 장소입니다.

컬럼타입설명역할
id문자열ID기술
venueCode문자열거래소 코드
name문자열거래소명
countryCode문자열국가
timezone문자열표준시
micCode문자열MIC기술

식별자 매핑IdentifierXref내부

identifier_xrefs

외부 식별자와 내부 법인을 잇는 표. DART 고유번호와 종목코드가 한 회사로 만나는 지점입니다.

컬럼타입설명역할
id문자열ID기술
subjectType문자열대상 종류
subjectId문자열대상
idScheme문자열식별자 체계
idValue문자열식별자 값
sourceId문자열출처
confidence소수신뢰도
validFrom일시유효 시작기술
validTo일시유효 종료기술