Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trydatawise.com/llms.txt

Use this file to discover all available pages before exploring further.

Connect Datawise to Postgres to enable Schema Radar detection and warehouse-level lineage.

Prerequisites

  • A Postgres user with SELECT privileges on information_schema and on the tables and views you want Datawise to track.
  • The hostname (or IP) and port for your Postgres instance.
  • The database name you want to connect.
Create a dedicated read-only Datawise user in Postgres rather than using an existing account.

Required Permissions

CREATE USER datawise_user WITH PASSWORD 'your_password';

GRANT CONNECT ON DATABASE your_database TO datawise_user;
GRANT USAGE ON SCHEMA public TO datawise_user;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO datawise_user;
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO datawise_user;

ALTER DEFAULT PRIVILEGES IN SCHEMA public
  GRANT SELECT ON TABLES TO datawise_user;
Repeat the GRANT USAGE and GRANT SELECT statements for each schema you want Datawise to ingest.

Connection Setup

Go to Connectors, click Add Connector, and select Postgres.

Required Fields

FieldDescription
Host and PortHostname and port. Format: hostname:port. Default Postgres port is 5432.
UsernameThe Postgres user Datawise connects as.
PasswordPassword for the above user.
DatabaseThe Postgres database to connect.
NameA display name for this connector in Datawise.

Filters

ScopeFieldDescription
SchemasAllow PatternsOnly ingest matching schemas.
SchemasDeny PatternsExclude matching schemas.
TablesAllow PatternsOnly ingest matching tables.
TablesDeny PatternsExclude matching tables.
ViewsAllow PatternsOnly ingest matching views.
ViewsDeny PatternsExclude matching views.
Patterns use glob syntax (e.g., prod_*). Leave all fields empty to ingest everything the user has access to.

Settings

SettingDefaultDescription
Include TablesOnIngest table metadata and schema.
Include ViewsOnIngest view metadata.
Enable Table ProfilingOffCollect row counts and basic statistics per table.
Enable Column ProfilingOffCollect column-level statistics. Increases query load.
Enable Stateful IngestionOffProcess only new or changed assets on subsequent runs.

Schedule

FieldDescription
Run on a scheduleRecommended.
ScheduleCron-style schedule. Default: every day at 00:00.
TimezoneThe timezone used to evaluate the schedule.

Testing the Connection

If the test fails, check:
  • That the hostname and port are reachable from Datawise. If your Postgres instance is behind a VPC or firewall, contact support for the current Datawise IP allowlist range.
  • That the user exists and the password is correct.
  • That the user has been granted CONNECT on the target database.

After Connecting

  • Tables and views from the connected schemas appear in Data Assets.
  • Schema Radar begins detecting schema changes on your configured schedule.
  • Lineage from Postgres populates when dbt Cloud is also connected and targeting the same Postgres instance.