非表示のコードリポジトリ

Code Workbook は、ブランチを使用した軽量なバージョン管理を提供します。また、すべてのワークブックには、専用の非表示のコードリポジトリが用意されています。このリポジトリは、コードワークブックに記述されたコードの安全なバックアップとして機能すると同時に、ワークブックで行われたすべてのコード変更の履歴を確認できるようにします。

ワークブックの非表示のコードリポジトリにアクセスするには、Code Workbook インターフェースの右上にある歯車アイコンのメニューを開き、非表示の Code Repository を開くを選択します。

特有の性質

ワークブックの非表示のリポジトリには、常に次の性質があります。

• リポジトリは読み取り専用です： リポジトリの内容は閲覧のみ可能で、リポジトリ内で直接更新することはできません。リポジトリを更新する唯一の方法は、ワークブックでコードを変更することです。
• リポジトリはデフォルトで非表示です： Code Workbook インターフェースからのみ発見可能です。
• リポジトリには3つの個別のファイルが保存されます：pipeline.R、pipeline.py、pipeline.sql の各ファイルには、変換されたワークブックの対応する言語のコードがすべて含まれます。
• リポジトリには完全な変更履歴が保存されます： ブランチごとのワークブックのコード変更の完全な履歴は、非表示のリポジトリのブランチタブで確認できます。
• **リポジトリには非表示の workbook.yml ファイルが含まれます：**このファイルには、ワークブックに関する基本的なメタデータが保存されます。

ワークブックのブランチでコードを変更するたびに、非表示のコードリポジトリの対応するブランチに新しいコミットが自動的に作成されます。

コードの変換

Code Workbook のコードは、非表示のリポジトリにコミットされると、Code Repository の構文に自動的に変換されます。たとえば、Code Workbook に次のコードセルがあるとします。

Copied!
1
2
def rename_column(dataset):
    return dataset.withColumnRenamed("old_name", "new_name")

このコードは、非表示のリポジトリの pipeline.py ファイルで次のように変換されます。

Copied!
1
2
3
4
5
6
@transform_pandas(
    Output(rid="ri.foundry.main.dataset.id-1"),
    dataset=Input(rid="ri.vector.main.dataset.id-2")
)
def rename_column(dataset):
    return dataset.withColumnRenamed("old_name", "new_name")

コードワークブックに同じ言語のコードセルが複数ある場合、各コードセルは、その言語に対応する1つのファイルに追加されます。R の場合は pipeline.R、Python の場合は pipeline.py、SQL の場合は pipeline.sql です。これにより、特定の言語のコードをすべて1つのファイルで表示できます。ワークブックのグローバルコードセクションに記述されたコードも、対応するファイルに保存されます。

失われたコードを復元する

非表示のコードリポジトリにはワークブックのバックアップが定期的に保存されるため、失われたコードや誤って削除されたコードを復元する方法として推奨されます。ワークブックの特定のブランチの履歴を確認するには、非表示のリポジトリの上部にあるブランチタブを開き、目的のブランチ（master など）を選択してから、コード変更を確認したいコミットを選択します。その後、コードをコピーしてワークブックに貼り付けることができます。