diff --git a/docs/_source/guides/log_load_and_prepare_data.ipynb b/docs/_source/guides/log_load_and_prepare_data.ipynb
index d829934d0c..fe0861f2f9 100644
--- a/docs/_source/guides/log_load_and_prepare_data.ipynb
+++ b/docs/_source/guides/log_load_and_prepare_data.ipynb
@@ -1,7 +1,6 @@
{
"cells": [
{
- "attachments": {},
"cell_type": "markdown",
"id": "d09c1533-97fd-43f7-83ea-f3a56edd1d5e",
"metadata": {},
@@ -16,7 +15,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "ae9d4c9e-24a1-4a59-8a17-3b6ac1a39c88",
"metadata": {},
@@ -108,7 +106,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "14a65408",
"metadata": {},
@@ -171,7 +168,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "a3f35f3b",
"metadata": {},
@@ -204,7 +200,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "b6cc89f8",
"metadata": {},
@@ -215,7 +210,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "381b5f0b",
"metadata": {},
@@ -244,7 +238,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "ee0f9b20",
"metadata": {},
@@ -280,7 +273,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "eed77791",
"metadata": {},
@@ -310,7 +302,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "df88889b-12f4-472f-bcbe-fb47be475d02",
"metadata": {},
@@ -411,9 +402,74 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
- "id": "289724c8",
+ "id": "0f3ccb75",
+ "metadata": {},
+ "source": [
+ "## Migrating dataset from \"emtpy\" workspaces\n",
+ "\n",
+ "For old argilla versions, datasets could be created with no workspace inf (`-` workspace in UI). New versions expect to work with datasets in a given workspace.\n",
+ "\n",
+ "If you have datasets within an empty workspaces, you should move them to a specific workspace to keep your workflow compatible with the latest versions\n",
+ "\n",
+ "
\n",
+ "\n",
+ "Warning\n",
+ "\n",
+ "From argilla version v1.4.0, datasets with empty workspace won't be supported anymore, and you should migrate them before upgrading argilla.\n",
+ "\n",
+ "
"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b758c202-4b4c-4275-8aa8-047539ea2df0",
+ "metadata": {},
+ "source": [
+ "Here is a code snippet showing how to do it"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "360b0075",
+ "metadata": {
+ "collapsed": false,
+ "jupyter": {
+ "outputs_hidden": false
+ }
+ },
+ "outputs": [],
+ "source": [
+ "import argilla as rg\n",
+ "from argilla.client import api\n",
+ "\n",
+ "rg.init()\n",
+ "rg_client = api.active_client()\n",
+ "\n",
+ "new_workspace = \"\"\n",
+ "\n",
+ "empty_workspace_datasets = [\n",
+ " ds[\"name\"]\n",
+ " for ds in rg_client.http_client.get(\"/api/datasets\")\n",
+ " if not ds.get(\"owner\", None) # filtering dataset with no workspace (owner field)\n",
+ "]\n",
+ "\n",
+ "rg.set_workspace(\"\") # working from the \"empty\" workspace\n",
+ "\n",
+ "for dataset in empty_workspace_datasets:\n",
+ " rg.copy(dataset, dataset, new_workspace)\n",
+ "\n",
+ "# Dataset are normally copied to the provided workspace\n",
+ "# You should delete datasets with no workspace\n",
+ "# In that case, uncomment following lines\n",
+ "# for dataset in empty_workspace_datasets:\n",
+ "# rg.delete(dataset)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "6f945b5c",
"metadata": {},
"source": [
"## Reindex a Dataset\n",
@@ -422,7 +478,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "aa5a3998",
"metadata": {},
@@ -447,7 +502,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "f92935ce",
"metadata": {},
@@ -473,7 +527,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "eb290a71-ad07-496f-b167-ad80d91fa633",
"metadata": {},
@@ -531,7 +584,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "f2d5b02c-a24c-40d0-80ce-6332fba15318",
"metadata": {},
@@ -543,7 +595,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "f6ae027b",
"metadata": {},
@@ -597,7 +648,6 @@
]
},
{
- "attachments": {},
"cell_type": "markdown",
"id": "907714da-5496-4a49-bc6d-2d9008d0082f",
"metadata": {},
@@ -646,7 +696,7 @@
],
"metadata": {
"kernelspec": {
- "display_name": "argilla",
+ "display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
@@ -660,7 +710,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
- "version": "3.9.15 | packaged by conda-forge | (main, Nov 22 2022, 08:50:29) \n[Clang 14.0.6 ]"
+ "version": "3.7.12"
},
"vscode": {
"interpreter": {