Skip to content
48 changes: 48 additions & 0 deletions doc/source/user_guide/io.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1613,6 +1613,53 @@ a permanent store.
.. _fsimpl1: https://filesystem-spec.readthedocs.io/en/latest/api.html#built-in-implementations
.. _fsimpl2: https://filesystem-spec.readthedocs.io/en/latest/api.html#other-known-implementations

Loading data in Google Colab notebooks
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Google Colab is a hosted Jupyter notebook environment. Since it runs remotely,
files must be explicitly uploaded or mounted before they can be read by pandas.

Uploading local files
^^^^^^^^^^^^^^^^^^^^^

Files can be uploaded directly to the Colab runtime using ``google.colab.files``:

.. code-block:: python

from google.colab import files
uploaded = files.upload()

import pandas as pd
df = pd.read_csv("data.csv")

Using Google Drive
^^^^^^^^^^^^^^^^^

Google Drive can be mounted to make files available to the runtime:

.. code-block:: python

from google.colab import drive
drive.mount("/content/drive")

import pandas as pd
df = pd.read_csv("/content/drive/MyDrive/data.csv")

Loading data from a URL
^^^^^^^^^^^^^^^^^^^^^^

Data hosted remotely can be read directly using a URL:

.. code-block:: python

import pandas as pd

url = (
"https://raw.githubusercontent.com/pandas-dev/pandas/main/"
"doc/data/air_quality_no2.csv"
)
df = pd.read_csv(url)

Writing out data
''''''''''''''''

Expand Down Expand Up @@ -6520,3 +6567,4 @@ The files ``test.pkl.compress``, ``test.parquet`` and ``test.feather`` took the
24009288 Oct 10 06:43 test_fixed_compress.hdf
24458940 Oct 10 06:44 test_table.hdf
24458940 Oct 10 06:44 test_table_compress.hdf

Loading