๐ โ์์ด์ ํธ์ ๋๋โ๋ ๊ฒฐ๊ตญ ํด๋ ํ๋์๋ค, ๊ตฌ๊ธ OKF 5๋ถ ์์ ์ ๋ณต (๊ณต์ ์คํ ๊ธฐ์ค)
ํต์ฌ ํ ์ค. OKF๋ โ๊ฐ๋
ํ๋ = ๋งํฌ๋ค์ด ํ์ผ ํ๋โ์ธ ์๋์ฅ์ด๊ณ , ํ์ผ ๊ฒฝ๋ก์์ .md๋ง ๋ ๊ฒ ๊ทธ ๊ฐ๋
์ ID๋ค(tables/orders.md โ ๊ฐ๋
ID tables/orders). ์๋๋ ์คํ ๋ถ๋ก์ ๋ฏธ๋๋ฉ ๋ฒ๋ค.
my_bundle/
โโ index.md
โโ log.md
โโ datasets/
โ โโ sales.md
โโ tables/
โโ orders.md
โโ customers.md
๊ฐ์ ๋๋ ๊ฑด ์
๋ฟ(์ ํฉ์ฑ ์กฐ๊ฑด).
โข๋ชจ๋ ์ผ๋ฐ .md๋ ํ์ฑ ๊ฐ๋ฅํ YAML ํ๋ก ํธ๋งคํฐ๋ฅผ ๊ฐ์ง ๊ฒ
โข๊ทธ ์์ ๋น์ด์์ง ์์ type ํ๋๊ฐ ์์ ๊ฒ (์ ์ผํ ํ์)
โข์์ฝ ํ์ผ index.md, log.md๋ ์ ํด์ง ํ์์ ๋ฐ๋ฅผ ๊ฒ
๊ฐ๋
ํ์ผ(tables/orders.md) ์๋ณธ.
---
type: BigQuery Table
title: Orders
description: One row per completed customer order.
resource:
console.cloud.google.com/...
tags: [sales, orders]
timestamp: 2026-05-28T00:00:00Z
---
# Schema
| Column | Type | Description |
|-------------|--------|-------------|
| order_id | STRING | Unique order identifier. |
| customer_id | STRING | FK to [customers](/tables/customers.md). |
# Joins
Joined with [customers](/tables/customers.md) on `customer_id`.
ํ์๋ type ํ๋, ๋๋จธ์ง(title, description, resource, tags, timestamp)๋ ๊ถ์ฅ. ๋ณธ๋ฌธ์ freeform๋ณด๋ค ํ,ํค๋ฉ ๊ฐ์ ๊ตฌ์กฐ๋ฅผ ๊ถ์ฅํ๊ณ ๊ด๋ก ํค๋ฉ์ # Schema, # Examples, # Citations. ๊ทธ๋ฆฌ๊ณ ํต์ฌ, ์กฐ์ธ,์ฐธ์กฐ ๊ฐ์ ๊ด๊ณ์ ์ข
๋ฅ๋ ๋งํฌ๊ฐ ์๋๋ผ ์ ๋ฌธ์ฅ(prose)์ด ์ ํ๋ค(ยง5.3). ๋งํฌ๋ ์ ๋ํ /tables/customers.md(๊ถ์ฅ)์ ์๋ํ ./other.md ๋.
์ด์ ํน์ ํ์ผ ๋. ๋ ๋ค ๋ด์ฉ ํ์์ด ์ ํด์ ธ ์๋ค.
index.md (์๋ด๋, ํ๋ก ํธ๋งคํฐ ์์, ํค๋ฉ ์๋ ๋ถ๋ฆฟ ๋ชฉ์ฐจ)
# Tables
* [Orders](orders.md) - ์๋ฃ๋ ์ฃผ๋ฌธ 1๊ฑด๋น 1ํ
* [Customers](customers.md) - ๊ณ ๊ฐ ๋ง์คํฐ
# Datasets
* [Sales](../datasets/sales.md) - ํ๋งค ๊ด๋ จ ํ
์ด๋ธ ๋ชจ์
log.md (๋ณ๊ฒฝ ์ด๋ ฅ, ์ต์ ์, ๋ ์ง๋ YYYY-MM-DD, ์ ๊ตต์ ๋จ์ด๋ ๊ด๋ก)
# Directory Update Log
## 2026-05-22
* **Update**: [๊ณ ๊ฐ ์งํ](/tables/customer-metrics.md) ์ฐธ์กฐ ์ถ๊ฐ
* **Creation**: [Dataplex ํ๋ ์ด๋ถ](/playbooks/dataplex.md) ์ ์ค
## 2026-05-15
* **Initialization**: ๊ธฐ๋ณธ ํด๋ ๊ตฌ์กฐ ์์ฑ
๐ฌ ๊ทธ๋์ โ์ฃผ๊ฐํ์ฑ์ฌ์ฉ์ ์ด๋ป๊ฒ ๊ตฌํด?โ๊ฐ ๋ค์ด์ค๋ฉด ์์ด์ ํธ๋ ๋ฃจํธ index.md๋ก ์ง๋ ๋ณด๊ณ , ์ ์ ํ์ผ ์ฝ๊ณ , ๋งํฌ ํ๊ณ tables๋ก ๊ฐ ์ปฌ๋ผ,์กฐ์ธ ๋ฌธ์ฅ์ ์ฝ์ด ๋ต์ ์กฐ๋ฆฝํ๋ค. ์๋ํ๋ฉด ๋ต์ด ํ ํ์ผ์ด ์๋๋ผ ๋งํฌ,๋ฌธ์ฅ์ ๋ฐ๋ผ ๋ชจ์ด๋๋ก ์ค๊ณ๋๊ธฐ ๋๋ฌธ.
์ ๋ฆฌํ๋ฉด 1) ๊ตฌ์กฐ๋ ์ต์(ํ์ type ํ๋), ๊ด๊ณ,์๋ฏธ๋ ๋ณธ๋ฌธ ์์ฐ์ด๊ฐ ์ง์ด์ง๋ค 2) ๊นจ์ง ๋งํฌ,๋ชจ๋ฅด๋ type,๋น ์นธ์ด ์์ด๋ ๋ฒ๋ค์ ๊ฑฐ๋ถํ๋ฉด ์ ๋๋ โ๊ด๋ํ ์๋นโ ์์น์ด๋ผ ์ฅ๋ฒฝ์ด ๊ฑฐ์ 0์ด๊ณ & 3) OKF๋ Avro,Protobuf,OpenAPI๋ฅผ ๋์ฒดํ๋ ๊ฒ ์๋๋ผ ๊ฐ๋ฆฌํฌ(references) ๋ฟ, ์ง์ ์ธต๋ง ํ์คํํ ๊ฒ.
๋ฐ๋ฉด์ ์ด ๋จ์ํจ์ด ์๋ ์ผ ์๋. ๊ด๊ณ,๋ก๊ทธ๋ฅผ ๋ฌธ์ฅ์ผ๋ก ์ฐ๋ ๋งํฌ๊ฐ ์ ๊ฐ๊ฐ์ด๋ฉด ๊ธฐ๊ณ ํ์ฑ์ด ํ๋ค๋ฆฐ๋ค. ์ด์ฉ๋ฉด ํ์ค์ ์นํจ๋ ๊ธฐ๋ฅ์ด ์๋๋ผ โ์ผ๋ง๋ ์ ๊ท์ฐฎ์๊ฐโ, ๊ทธ๋ฆฌ๊ณ ํ์ด type,๋ฌธ์ฅ ์ปจ๋ฒค์
์ ๋ง์ถ๋๋๊ฐ ๊ฐ๋ฅผ์ง๋. ์ผ๋จ index.md ํ ์ฅ๋ถํฐ.
#OKF #์ง์๊ทธ๋ํ #AI์์ด์ ํธ
๐ ์ถ์ฒ (๊ณต์):
โข์ค๊ณ ์๋์ ์์ โ Google Cloud, Introducing OKF:
cloud.google.com/blog/producโฆ
โขv0.1 ์คํ ์ ๋ฌธ(ยง5.3 ๋งํฌ, ยง6 index, ยง7 log, ๋ถ๋ก ๋ฏธ๋๋ฉ ๋ฒ๋ค) โ okf/SPEC.md:
github.com/GoogleCloudPlatfoโฆ