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": {