Databricksワークスペースのオブジェクトを操作する

[Work with workspace objects \| Databricks on AWS](https://docs.databricks.com/workspace/workspace-objects.html) [2022/5/17時点]の翻訳です。

:::note warn
本書は抄訳であり内容の正確性を保証するものではありません。正確な内容に関しては原文を参照ください。
:::

> [Databricksクイックスタートガイド](https://qiita.com/taka_yayoi/items/125231c126a602693610)のコンテンツです。

本書では、フォルダーと他のワークスペースのオブジェクトをどのように操作するのかを説明します。

# フォルダー

フォルダーには、ノートブック、ライブラリ、エクスペリメント、その他のフォルダーと言ったワークスペース内のすべての静的なアセットが含まれています。フォルダーを開いたり、閉じたり、中身を見るにはフォルダー名をクリックします。
![](https://docs.databricks.com/_images/folder-open.png)

フォルダーに対するアクションを実行するには、フォルダーの右側にある![](https://docs.databricks.com/_images/down-caret.png)をクリックし、メニューの項目を選択します。
![](https://docs.databricks.com/_images/folder-menu.png)

## 特殊なフォルダー

Databricksワークスペースには、ワークスペース、Shared、Usersという特殊なフォルダーがあります。これらの特殊なフォルダーの名前の変更、移動はできません。

## ワークスペースのルートフォルダー

ワークスペースのルートフォルダーに移動するには、

1. ![](https://docs.databricks.com/_images/workspace-icon.png)**Workspace**をクリックします。
1. ![](https://docs.databricks.com/_images/scroll-left-icon.png)アイコンをクリックします。

ワークスペースのルートフォルダーには、皆様の組織のDatabricksの静的なすべてのアセットが格納されています。
![](https://docs.databricks.com/_images/workspace-folder.png)

ワークスペースのルートフォルダーには以下のフォルダーがあります。
- ![](https://docs.databricks.com/_images/shared-icon.png)**Shared**は、組織内でオブジェクトを共有するためのフォルダーです。すべてのユーザーは、Sharedのすべてのオブジェクトに対して完全なアクセス権を有しています。
- ![](https://docs.databricks.com/_images/users-icon1.png)**Users**には、ユーザーごとのフォルダーが格納されています。

デフォルトでは、ワークスペースのルートフォルダーとそこに格納されているオブジェクトは*すべてのユーザーがアクセスできます*。[ワークスペースのアクセスコントロールを有効化](https://docs.databricks.com/administration-guide/access-control/workspace-acl.html#enable-workspace-acl)し、[アクセス権](https://qiita.com/taka_yayoi/items/2dd6711b7b254505e4a3#%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80%E3%81%AE%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E6%A8%A9)を設定することで、誰がオブジェクトにアクセスできるのかをコントロールすることができます。

すべてのフォルダーの全てのオブジェクトをアルファベット順、あるいはタイプ別にソートするには、ワークスペースのフォルダーの右にある![](https://docs.databricks.com/_images/down-caret.png)をクリックし、**Sort > [Alphabetical | Type]**を選択します。
![](https://docs.databricks.com/_images/workspace-sort.png)

## ユーザーのホームフォルダー

それぞれのユーザーには、自分のノートブックやライブラリを格納するための*ホームフォルダー*が存在します。
![](https://docs.databricks.com/_images/home-folder.png)

ワークスペースのアクセスコントロールが有効化されている場合、デフォルトはこのフォルダーのオブジェクトは当該ユーザーのみが操作できるプライベートなものとなっています。

:::note info
**注意**
[ユーザーを削除](https://qiita.com/taka_yayoi/items/3262ea8529ad96b920ce#%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AE%E5%89%8A%E9%99%A4)しても、そのユーザーのホームフォルダーは維持されます。
:::

# ワークスペースのオブジェクトのオペレーション

ワークスペースのルートフォルダーに格納されるオブジェクトには、[フォルダー](#フォルダー)、[ノートブック](https://docs.databricks.com/workspace/workspace-assets.html#notebooks)、[ライブラリ](https://docs.databricks.com/workspace/workspace-assets.html#ws-libraries)、[エクスペリメント](https://qiita.com/taka_yayoi/items/ba0c7f46ff7c3dbf87bb#%E3%82%A8%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%AA%E3%83%A1%E3%83%B3%E3%83%88)があります。ワークスペースのオブジェクトにアクションを適用したい場合には、オブジェクトを右クリックする、あるいは、オブジェクトの右側にある![](https://docs.databricks.com/_images/menu-dropdown.png)をクリックします。
![](https://docs.databricks.com/_images/object-menu.png)

ドロップダウンメニューから以下のことを行えます。

- オブジェクトがフォルダーの場合
    - [ノートブック](https://qiita.com/taka_yayoi/items/24a897cf40bba6d9e305)、[ライブラリ](https://docs.databricks.com/libraries/index.html)、[MLflowエクスペリメント](https://qiita.com/taka_yayoi/items/ba0c7f46ff7c3dbf87bb#%E3%82%A8%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%AA%E3%83%A1%E3%83%B3%E3%83%88)、フォルダーの作成
    - [Databricksアーカイブ](https://qiita.com/taka_yayoi/items/c306161906d6d34e8bd5#%E3%83%8E%E3%83%BC%E3%83%88%E3%83%96%E3%83%83%E3%82%AF%E3%81%AE%E9%85%8D%E5%B8%83)のインポート
- オブジェクトのクローン
- オブジェクト名の変更
- 別のフォルダーにオブジェクトを移動
- オブジェクトをゴミ箱に移動。[オブジェクトの削除](#オブジェクトの削除)をご覧ください。
- ノートブックやフォルダーをDatabricksアーカイブとしてエクスポート
- オブジェクトがノートブックの場合、ノートブックのファイルパスをコピー
- [ワークスペースのアクセスコントロール](https://qiita.com/taka_yayoi/items/2dd6711b7b254505e4a3)が有効化されている場合、オブジェクトのアクセス権の設定

## ワークスペースのオブジェクトの検索

:::note info
**プレビュー**
本機能は[パブリックプレビュー](https://docs.databricks.com/release-notes/release-types.html)です。
:::

:::note info
**注意**
このセクションで説明されている検索機能は、[暗号化に顧客管理キー](https://docs.databricks.com/security/keys/customer-managed-keys.html)を用いているワークスペースではサポートされていません。これらのワークスペースにおいては、サイドバーの**Search**をクリックし、![](https://docs.databricks.com/_images/search-icon.png)**Search Workspace**フィールドに検索文字列をタイプします。タイプするたびに、名前に検索文字列を含むオブジェクトが一覧されます。ワークスペースでオブジェクトを開くには名前をクリックします。
:::

ワークスペースのオブジェクトを検索するために、サイドバーの![](https://docs.databricks.com/_images/search-icon.png)**Search**をクリックします。**Search**ダイアログが表示されます。

テキスト文字列で検索したい場合、検索フィールドにタイプしてEnterを押します。システムはワークスペースにあるすべてのノートブック、フォルダー、ライブラリ、Reposにおいて、あなたがアクセスできるものに対して検索を行います。また、ノートブックのコマンドも検索しますが、ノートブック以外のファイルのテキストは検索しません。

タイプ(ファイル、フォルダー、ライブラリ、レポ)に基づいてアイテムを検索することもできます。検索テキストは不要です。

Enterを押すと、検索条件にマッチするワークスペースオブジェクトがダイアログに表示されます。開くにはリストから名前をクリックします。

## 最近使用したオブジェクトへのアクセス

サイドバーの![](https://docs.databricks.com/_images/recents-icon.png)**Recents**をクリックするか、ワークスペースのランディングページにあるRecentsカラムから最近使用したオブジェクトにアクセスすることができます。

:::note info
**注意**
ブラウザーのキャッシュやcookieをクリアすると、Recentsのリストもクリアされます。
:::

## オブジェクトの移動

オブジェクトを移動するには、オブジェクトをドラッグ&ドロップするか、オブジェクトの右側の![](https://docs.databricks.com/_images/menu-dropdown.png)や![](https://docs.databricks.com/_images/down-caret.png)をクリックして、**Move**を選択します。
![](https://docs.databricks.com/_images/move-drop-down.png)

*フォルダー内の*すべてのオブジェクトを別のフォルダーに移動するには、ソースフォルダーに**Move**アクションを適用し、**Move all items in ‘<folder-name>’ rather than the folder itself**チェックボックスを選択します。
![](https://docs.databricks.com/_images/move-contents-check-box.png) 

## オブジェクトの削除

フォルダー、ノートブック、ライブラリ、エクスペリメントを削除するには、オブジェクトの右側の![](https://docs.databricks.com/_images/menu-dropdown.png)や![](https://docs.databricks.com/_images/down-caret.png)をクリックして、**Move to Trash**を選択します。ゴミ箱のフォルダーは**30日後**に自動で空になります。

オブジェクトの右の![](https://docs.databricks.com/_images/menu-dropdown.png)をクリックし、**Delete Immediately**を選択することで、恒久的にオブジェクトを削除することができます。
![](https://docs.databricks.com/_images/trash-delete.png)

ゴミ箱フォルダーの右の![](https://docs.databricks.com/_images/menu-dropdown.png)をクリックし、**Empty Trash**を選択することで、ゴミ箱内のすべてのオブジェクトを恒久的に削除することができます。
![](https://docs.databricks.com/_images/empty-trash.png)

## オブジェクトのリストア

![](https://docs.databricks.com/_images/trash-icon.png)ゴミ箱フォルダーからオブジェクトを他のフォルダーにドラッグすることで、オブジェクトをリストアすることができます。

### Databricks 無料トライアル

[Databricks 無料トライアル](https://databricks.com/jp/try-databricks)