feat: Add Ocient support (#22812)

Co-authored-by: jwilliams-ocient <60358443+jwilliams-ocient@users.noreply.github.com>
Co-authored-by: Jordan Williams <jwilliams@ocient.com>
Co-authored-by: rmasters1 <100157128+rmasters1@users.noreply.github.com>
This commit is contained in:
alexclavel-ocient
2023-04-22 20:49:32 -05:00
committed by GitHub
parent 669e1802a6
commit adde66785c
4 changed files with 598 additions and 0 deletions

View File

@@ -0,0 +1,37 @@
---
title: Ocient DB
hide_title: true
sidebar_position: 20
version: 1
---
## Ocient DB
The recommended connector library for Ocient is [sqlalchemy-ocient](https://pypi.org/project/sqlalchemy-ocient).
## Install the Ocient Driver
```
pip install sqlalchemy-ocient
```
## Connecting to Ocient
The format of the Ocient DSN is:
```shell
ocient://user:password@[host][:port][/database][?param1=value1&...]
```
The DSN for connecting to an `exampledb` database hosted at `examplehost:4050` with TLS enabled is:
```shell
ocient://admin:abc123@examplehost:4050/exampledb?tls=on
```
**NOTE**: You must enter the `user` and `password` credentials. `host` defaults to localhost,
port defaults to 4050, database defaults to `system` and `tls` defaults
to `unverified`.
## User Access Control
Make sure the user has privileges to access and use all required databases, schemas, tables, views, and warehouses, as the Ocient SQLAlchemy engine does not test for user or role rights by default.