jupyter notebook extension to connect to graph databases
Project description
graph-notebook
Python package integrating jupyter notebooks with various graph-stores including Apache TinkerPop and RDF SPARQL.
Requirements
- Python 3.6.1 or higher, Python 3.7
- Jupyter Notebooks
Installation
# install the package
pip install graph-notebook
# install and enable the visualization widget
jupyter nbextension install --py --sys-prefix graph_notebook.widgets
jupyter nbextension enable --py --sys-prefix graph_notebook.widgets
# copy static html resources
python -m graph_notebook.static_resources.install
python -m graph_notebook.nbextensions.install
# copy premade starter notebooks
python -m graph_notebook.notebooks.install --destination /notebook/destination/dir
# start jupyter
jupyter notebook /notebook/destination/dir
Configuration
In order to connect to your graph database, you have three configuration options.
- Change the host setting in your opened jupyter notebook by running the following in a notebook cell:
%graph_notebook_host you-endpoint-here
- Change your configuration entirely grabbing the current configuration, making edits, and saving it to your notebook by running the following cells:
# 1. print your configuration
%graph_notebook_config
# default config will be printed if nothing else is set:
{
"host": "change-me",
"port": 8182,
"auth_mode": "DEFAULT",
"iam_credentials_provider_type": "ROLE",
"load_from_s3_arn": "",
"ssl": true,
"aws_region": "us-east-1"
}
# 2. in a new cell, change the configuration by using %%graph_notebook_config (note the two leading %% instead of one)
%%graph_notebook_config
{
"host": "changed-my-endpoint",
"port": 8182,
"auth_mode": "DEFAULT",
"iam_credentials_provider_type": "ENV",
"load_from_s3_arn": "",
"ssl": true,
"aws_region": "us-east-1"
}
- Store a configuration under ~/graph_notebook_config.json
echo "{
"host": "changed-my-endpoint",
"port": 8182,
"auth_mode": "DEFAULT",
"iam_credentials_provider_type": "ENV",
"load_from_s3_arn": "",
"ssl": true,
"aws_region": "us-east-1"
}" >> ~/graph_notebook_config.json
Authentication
If you are running a SigV4 authenticated endpoint, ensure that the config field iam_credentials_provider_type
is set
to ENV
and that you have set the following environment variables:
- AWS_ACCESS_KEY_ID
- AWS_SECRET_ACCESS_KEY
- AWS_REGION
- AWS_SESSION_TOKEN (OPTIONAL. Use if you are using temporary credentials)
Security
See CONTRIBUTING for more information.
License
This project is licensed under the Apache-2.0 License.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
graph-notebook-1.33.0.dev1.tar.gz
(61.5 MB
view hashes)
Built Distribution
Close
Hashes for graph-notebook-1.33.0.dev1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3228a8b61d3f9520bc6e03ebee7b4f03524edd668b6d9a955f54f2bbe91884ac |
|
MD5 | 03c987dc6c2dc6aa2a19758d7bbd1c19 |
|
BLAKE2b-256 | 6931daa01fb3947b008bc70ac2822c33f4d3711716753dd17029bf84b3b357f6 |
Close
Hashes for graph_notebook-1.33.0.dev1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 200d7a52546ee1fe1d1493ef8220e655010d9f029b391466d26a475038141b8a |
|
MD5 | b601df076bcc3f4b8effffdb7c1ceacb |
|
BLAKE2b-256 | 69830fd7bf6529bbf75f67c4d5ca544e6cf4088af1a6b6aeda0869f9340e4da9 |