ibis.sql.postgres.api.connect¶
-
ibis.sql.postgres.api.
connect
(host=None, user=None, password=None, port=None, database=None, url=None, driver=None)¶ Create an Ibis client located at user:password`@`host:port connected to a PostgreSQL database named database.
Parameters: host : string, default None
user : string, default None
password : string, default None
port : string or integer, default None
database : string, default None
url : string, default None
Complete SQLAlchemy connection string. If passed, the other connection arguments are ignored.
driver : string, default ‘psycopg2’
Returns: PostgreSQLClient
Examples
>>> import os >>> import getpass >>> user = os.environ.get('IBIS_POSTGRES_USER', getpass.getuser()) >>> password = os.environ.get('IBIS_POSTGRES_PASS') >>> database = os.environ.get('IBIS_TEST_POSTGRES_DB', 'ibis_testing') >>> con = connect( ... database=database, ... host='localhost', ... user=user, ... password=password ... ) >>> con.list_tables() [...] >>> t = con.table('functional_alltypes') >>> t PostgreSQLTable[table] name: functional_alltypes schema: index : int64 Unnamed: 0 : int64 id : int32 bool_col : boolean tinyint_col : int16 smallint_col : int16 int_col : int32 bigint_col : int64 float_col : float double_col : double date_string_col : string string_col : string timestamp_col : timestamp year : int32 month : int32