12 repoを役割別に並べ、今日読む1つを選ぶ
学習時間の目安: 30 分.
- 1読者の疑問
- 2リポジトリの役割
- 3製品と管理主体の境界
- 4調べる機能を1つ選ぶ
独自の学習図。矢印は読み進める順序や判断の流れを表し、実測した実行traceではない。
この章の状態
本文は資料を読んで作成した教材です。実repoのbuild/test/debug、実API呼出し、Issue/PR投稿は行っていません。実践はこれから行う課題で、閲覧を実行結果と扱いません。
この講座の入口
Codex・Databricks関連のOSSを読み、理解を確かめ、各プロジェクトの受付方針に合った貢献を準備するワークブック。
巨大repoを一度に理解する代わりに、1機能を根拠付きで追う8章。学習と公開貢献は別の到達点。
Gitと1言語の基礎がある人向け。学習時間の目安：5.75時間。初期12 repoのキュレーション。網羅を主張しない。
前提：
- Gitのcommit/branch/diff
- 関数・型・例外
- 端末の基本
学習目標
- 12 repoを役割別に並べ、今日読む1つを選ぶ
全集を目指さない
今回の12件は最初のカタログで、関連OSSすべての一覧ではない。『関連』には公式実装、公式クライアント、依存・隣接プロジェクト、コミュニティ拡張がある。まず利用者・入力・出力・外部サービスの4点を押さえる。巨大repoをファイル順に読まない。
見取り図
Codexは端末側の公開コードを読める。DatabricksではCLI、管理用SDK、SQL Connectorが別の入口。Sparkは計算エンジン、Delta Lakeはテーブルとストレージの仕組み、MLflowはAI開発の追跡・評価等、Unity Catalog OSSはカタログのプロジェクトである。全部をDatabricks公式repoと呼ばない。
最初の選択
PythonならSDK Python、設定から処理を追いたいならCLI、AIツールに興味があればCodexから始める。初週は1 repoでよい。Spark全体の理解をSDKの小さな再現実験の前提にしない。
初期12件のリポジトリカタログ
この12件は初期の選定です。公式・隣接・コミュニティという分類は拡張できますが、初期12件にはコミュニティrepoをまだ収録していません。網羅一覧・人気順・全実装確認済みという意味ではありません。各カードの確認日は2026-10-03で、READMEと公開構成の確認は全ソースの精読とは区別します。
| 分類 | 関係を見る基準 |
|---|---|
| 公式 | 公開主体がOpenAIまたはDatabricksである実装・クライアント・SDK |
| 隣接OSS | 依存・接続・業界上の関係がある、所有者の異なるプロジェクト |
| コミュニティ | 第三者の拡張。今後追加するときに関係の根拠を確認する |
Codexの到達点はPR提出ではありません。 現在の公式貢献ガイドでは外部コード貢献・PRを受け付けません。再現・原因分析・Issue草稿へ進み、公開投稿の直前に方針を再確認します。
openai/codex
ID: codex · 確認日: 2026-10-03
公式リポジトリ：openai/codex
- 分類: OpenAI公式
- 言語: Rust / TypeScript
- 向いている学び: 最優先・読解と原因分析
- 貢献方針と注意: 外部コード貢献・PRは現在受付対象外。再現と原因分析を草稿にする
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
読んだ範囲：codex-rs/app-server/README.md — プロトコル文書を確認。アプリ全体の公開を意味しない
Source ID: codex-app.
確認したCodexのDeepWikiを外部で読む。リンクの利用可能性の確認であり、説明の正しさの保証ではありません。
databricks/cli
ID: cli · 確認日: 2026-10-03
公式リポジトリ：databricks/cli
- 分類: Databricks公式
- 言語: Go
- 向いている学び: 最優先・Bundle処理
- 貢献方針と注意: 開発手順を確認。公開貢献前に受付方針を再確認
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
読んだ範囲：bundle/bundle.go — 本文のBundle/Mutator説明とSDK importを確認
Source ID: cli-bundle.
databricks/databricks-sdk-py
ID: sdk-py · 確認日: 2026-10-03
公式リポジトリ：databricks/databricks-sdk-py
- 分類: Databricks公式
- 言語: Python
- 向いている学び: 最初の実践候補・HTTP境界
- 貢献方針と注意: 公開ミラー。PRを公開レビューし内部で反映。署名・DCO要件あり
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
読んだ範囲：databricks/sdk/core.py — コンストラクタの_BaseClientへの設定受け渡しを確認
Source ID: sdk-core.
databricks/databricks-sdk-go
ID: sdk-go · 確認日: 2026-10-03
公式リポジトリ：databricks/databricks-sdk-go
- 分類: Databricks公式
- 言語: Go
- 向いている学び: CLIの下層理解
- 貢献方針と注意: 投稿前に貢献ガイドを再読
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
実装を読んだ範囲 codeAreas: []。未読のpathや詳細なアーキテクチャを推測で補いません。
databricks/databricks-sdk-java
ID: sdk-java · 確認日: 2026-10-03
公式リポジトリ：databricks/databricks-sdk-java
- 分類: Databricks公式
- 言語: Java
- 向いている学び: JVMの発展
- 貢献方針と注意: 投稿前に貢献ガイドを再読
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
実装を読んだ範囲 codeAreas: []。未読のpathや詳細なアーキテクチャを推測で補いません。
databricks/databricks-sql-python
ID: sql-python · 確認日: 2026-10-03
公式リポジトリ：databricks/databricks-sql-python
- 分類: Databricks公式
- 言語: Python
- 向いている学び: SQLクライアント境界
- 貢献方針と注意: 管理用SDKとの用途差を学ぶ
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
実装を読んだ範囲 codeAreas: []。未読のpathや詳細なアーキテクチャを推測で補いません。
databricks/terraform-provider-databricks
ID: terraform · 確認日: 2026-10-03
公式リポジトリ：databricks/terraform-provider-databricks
- 分類: Databricks公式
- 言語: Go
- 向いている学び: IaC・状態管理
- 貢献方針と注意: 実リソース操作は費用・権限の別確認が必要
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
実装を読んだ範囲 codeAreas: []。未読のpathや詳細なアーキテクチャを推測で補いません。
mlflow/mlflow
ID: mlflow · 確認日: 2026-10-03
公式リポジトリ：mlflow/mlflow
- 分類: 隣接OSS・独立プロジェクト
- 言語: Python / TypeScript
- 向いている学び: AI評価・追跡の貢献候補
- 貢献方針と注意: 現行ガイドはissueと実装方針の相談を推奨
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
実装を読んだ範囲 codeAreas: []。未読のpathや詳細なアーキテクチャを推測で補いません。
apache/spark
ID: spark · 確認日: 2026-10-03
公式リポジトリ：apache/spark
- 分類: 隣接OSS・Apacheプロジェクト
- 言語: Scala / Java / Python
- 向いている学び: 実行エンジンとSpark Connect
- 貢献方針と注意: Databricks所有repoと表記しない
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
実装を読んだ範囲 codeAreas: []。未読のpathや詳細なアーキテクチャを推測で補いません。
delta-io/delta
ID: delta · 確認日: 2026-10-03
公式リポジトリ：delta-io/delta
- 分類: 隣接OSS・Delta Lakeプロジェクト
- 言語: Scala / Java / Python
- 向いている学び: テーブル形式・トランザクション
- 貢献方針と注意: 計算エンジンとの境界を学ぶ
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
実装を読んだ範囲 codeAreas: []。未読のpathや詳細なアーキテクチャを推測で補いません。
delta-io/delta-rs
ID: delta-rs · 確認日: 2026-10-03
公式リポジトリ：delta-io/delta-rs
- 分類: 隣接OSS・Delta Lakeプロジェクト
- 言語: Rust / Python
- 向いている学び: 言語境界
- 貢献方針と注意: 貢献ガイドのリンクは確認。本文取得は未完了
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
実装を読んだ範囲 codeAreas: []。未読のpathや詳細なアーキテクチャを推測で補いません。
unitycatalog/unitycatalog
ID: unitycatalog · 確認日: 2026-10-03
公式リポジトリ：unitycatalog/unitycatalog
- 分類: 隣接OSS・LF AI & Data sandbox project
- 言語: Java等
- 向いている学び: カタログ
- 貢献方針と注意: 商用Databricks Unity Catalogと同一視しない。AI_POLICYも確認
- 次の1行動: READMEの利用例を1つ選び、入力・出力・外部境界を4行で説明する
- Issueの現状: 未調査。open/未着手/初心者向けを保証しない
- 版の状態: 可変ブランチ確認。実践時にSHA固定
貢献・開発ガイド：［出典URLは非公開の出典記録に保持］
固定commit SHA：null（未確認）。可変ブランチの確認を固定版の検証と呼びません。
実装を読んだ範囲 codeAreas: []。未読のpathや詳細なアーキテクチャを推測で補いません。
カタログを追加するとき
canonical URL、公開主体、関連の根拠、ライセンス、archive状態、貢献方針、確認日を残します。初期カードにない値は未確認です。第三者のコードやDeepWikiの出力を転載せず、公式の出典へリンクします。
35件の一次資料と確認範囲
確認日は資料を読んだ日です。公開日・更新日や実行日とは異なります。各リンクは将来変わり得るので、実践時に対象commitと同じ版を確認してください。
- openai/codex 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- openai/codex 貢献・開発ガイド — 2026-10-03: 外部コード貢献・PRは現在受付対象外。再現と原因分析を草稿にする
- databricks/cli 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- databricks/cli 貢献・開発ガイド — 2026-10-03: 開発手順を確認。公開貢献前に受付方針を再確認
- databricks/databricks-sdk-py 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- databricks/databricks-sdk-py 貢献・開発ガイド — 2026-10-03: 公開ミラー。PRを公開レビューし内部で反映。署名・DCO要件あり
- databricks/databricks-sdk-go 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- databricks/databricks-sdk-go 貢献・開発ガイド — 2026-10-03: 投稿前に貢献ガイドを再読
- databricks/databricks-sdk-java 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- databricks/databricks-sdk-java 貢献・開発ガイド — 2026-10-03: 投稿前に貢献ガイドを再読
- databricks/databricks-sql-python 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- databricks/databricks-sql-python 貢献・開発ガイド — 2026-10-03: 管理用SDKとの用途差を学ぶ
- databricks/terraform-provider-databricks 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- databricks/terraform-provider-databricks 貢献・開発ガイド — 2026-10-03: 実リソース操作は費用・権限の別確認が必要
- mlflow/mlflow 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- mlflow/mlflow 貢献・開発ガイド — 2026-10-03: 現行ガイドはissueと実装方針の相談を推奨
- apache/spark 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- apache/spark 貢献・開発ガイド — 2026-10-03: Databricks所有repoと表記しない
- delta-io/delta 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- delta-io/delta 貢献・開発ガイド — 2026-10-03: 計算エンジンとの境界を学ぶ
- delta-io/delta-rs 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- delta-io/delta-rs 貢献・開発ガイド — 2026-10-03: 貢献ガイドのリンクは確認。本文取得は未完了
- unitycatalog/unitycatalog 公式repo — 2026-10-03: READMEと公開構成の確認。全ソース精読ではない
- unitycatalog/unitycatalog 貢献・開発ガイド — 2026-10-03: 商用Databricks Unity Catalogと同一視しない。AI_POLICYも確認
- Bundle実装 — 2026-10-03: 本文のBundle/Mutator説明とSDK importを確認
- ApiClient実装 — 2026-10-03: コンストラクタの_BaseClientへの設定受け渡しを確認
- Codex app-server文書 — 2026-10-03: プロトコル文書を確認。アプリ全体の公開を意味しない
- Codexビルドガイド — 2026-10-03: 実践時に同じcommitの手順を再確認
- DeepWiki公式MCP — 2026-10-03: 公開repo向け無認証MCP、/mcpを推奨
- DeepWiki公式説明 — 2026-10-03: iframe許可の仕様は確認できず
- Cognition Platform Terms — 2026-10-03: 2026-06-30更新。公開MCPへの適用範囲・転載許諾は未確定
- Cognition Privacy Policy — 2026-10-03: 連携時のデータ送信範囲を要確認
- Databricks Connect — 2026-10-03: Spark Connectを基盤とするDatabricks向け拡張
- Apache Spark Connect — 2026-10-03: クライアント・サーバー分離
- DatabricksとOSS — 2026-10-03: 企業製品とOSSの関係を確認する入口
実践課題: 全部の前に、境界をつかむの実践
- repoを1つ選ぶ
- 利用者・入力・出力・外部サービスを4行で書く
- READMEと貢献ガイドを開く
- 今回読まない領域を2つ決める
成果物: 役割カード1枚
理解チェック
まず答えを見ずに自分の言葉で答えます。以下は自己確認用の正答と説明であり、自動採点・実行結果ではありません。
Databricks ConnectとSpark Connectは同じ？
答え: Databricks ConnectはSpark Connectを基盤にしたDatabricks向け拡張。OSS実装と商用製品を区別する。
自分の学習進捗
記録方式: manual.
- 未着手
- 読んだ
- 試した
- 説明できる
閲覧だけで実践済みにしない
この章で使った資料
openai/codex 公式repo, databricks/cli 公式repo, databricks/databricks-sdk-py 公式repo, apache/spark 公式repo, Databricks Connect, DatabricksとOSS
現在のLearn版
2026-10-04に、この章群を共通Learnの教材として復旧した。原本の出典確認日は2026-10-03として保持する。旧共通実験画面はこの版にはないため、リンク先の手元の記録テンプレートを使い、観測結果を得るまで計画をnot-runとして残す。復旧作業では実験、順位、性能測定を作成していない。
MENTAL MODEL / 考える順序
発表から、自分の判断へ。
発表の主張と、論文・公式ドキュメントの条件を並べて読む。
出典
公開日は資料の日付、確認日は内容を参照した日です。コミュニティの観測は公式の確定事項と区別します。