Where to Log

By default, all data is logged to the current working directory to default.sqlite (sqlite:///default.sqlite).

Connecting with a Database URL

Data can be logged to a SQLAlchemy-compatible referred to by database_url in the format dialect+driver://username:password@host:port/database.

See this article for more details on SQLAlchemy database URLs.

For example, for Postgres database trulens running on localhost with username trulensuser and password password set up a connection like so.

Connecting with a Database URL

from trulens.core.session import TruSession
from trulens.core.database.connector.default import DefaultDBConnector
connector = DefaultDBConnector(database_url = "postgresql://trulensuser:password@localhost/trulens")
session = TruSession(connector = connector)

After which you should receive the following message:

🦑 TruSession initialized with db url postgresql://trulensuser:password@localhost/trulens.

Connecting to a Database Engine

Data can also logged to a SQLAlchemy-compatible engine referred to by database_engine. This is useful when you need to pass keyword args in addition to the database URL to connect to your database, such as connect_args.

See this article for more details on SQLAlchemy database engines.

Connecting with a Database Engine

from trulens.core.session import TruSession
from sqlalchemy import create_engine

database_engine = create_engine(
    "postgresql://trulensuser:password@localhost/trulens",
    connect_args={"connection_factory": MyConnectionFactory},
)
connector = DefaultDBConnector(database_engine = database_engine)
session = TruSession(connector = connector)

session = TruSession(database_engine=engine)

After which you should receive the following message:

``` 🦑 TruSession initialized with db url postgresql://trulensuser:password@localhost/trulens.