Google Cloud Datalab Python package. Used in Google Cloud Datalab and can be used in Jupyter Notebook.
This adds a number of Python modules such as google.datalab.bigquery
,
google.datalab.storage
, etc, for accessing
Google Cloud Platform services as well as adding
some new cell magics such as %chart
, %bigquery
, %storage
, etc.
See https://github.com/googledatalab/notebooks for samples of using this package.
Installation
This package is available on PyPI as datalab
:
pip install datalab
Using in Jupyter
After datalab installation, enable datalab's frontend in Jupyter by running:
jupyter nbextension install --py datalab.notebook --sys-prefix
See further details Jupyter Kernel and Notebook Extensions.
Then in a notebook cell, enable datalab's magics with:
%load_ext google.datalab.kernel
(Note: If you hit an error "module traceback cannot be imported", try setting the following environment variable: CLOUDSDK_PYTHON_SITEPACKAGES=1)
Alternatively add this to your ipython_config.py
file in your profile:
c = get_config()
c.InteractiveShellApp.extensions = [
'google.datalab.kernel'
]
You will typically put this under ~/.ipython/profile_default
. See
the IPython docs
for more about IPython profiles.
If you want to access Google Cloud Platform services such as BigQuery, you
will also need to install gcloud. You
will need to use gcloud
to authenticate; e.g. with:
gcloud auth login
You will also need to set the project ID to use; either set a PROJECT_ID
environment variable to the project name, or call
set_datalab_project_id(name)
from within your notebook.
Documentation
You can read the Sphinx generated docs at: http://googledatalab.github.io/pydatalab/
Development installation
If you'd like to work on the package, it's useful to be able to install from source. You will need the Typescript compiler installed.
First:
git clone https://github.com/googledatalab/pydatalab.git
cd pydatalab
Then do one of the folowing:
./install-virtualenv.sh # For use in Python virtual environments
./install-no-virtualenv.sh # For installing in a non-virtual environment
You can ignore the message about running jupyter nbextension enable
; it is
not required.