Skip to main content
In Credible, database connection configurations are stored securely in the Credible control plane. Database credentials never leave the Credible service. All access—whether for model development purposes or serving semantic models—goes through the Credible platform. In turn, the Credible service provides a secure perimeter around your databases.

​
Prerequisites

  • Admin access to an organization in the Credible platform in order to create an environment and connections.
If you don’t have admin access, contact your organization administrator to set up connections for you.

​
Setup Process

Let’s connect your data sources (BigQuery, Snowflake, PostgreSQL, Trino, Databricks, MySQL, DuckDB, MotherDuck) to Credible to start building semantic models. Connections provide secure access to your databases and data warehouses. Connections are added to an environment and become available to all packages within that environment.
  1. Access your organization at https://your-org.app.credibledata.com
  2. Select your environment from the left sidebar under Packages & Connections
  3. Click ”+ Add Connection” in the Connections section
  4. Choose your data source type and fill in the connection details:
Connection names cannot contain spaces or hyphens. Use underscores instead (e.g., my_connection).
BigQuery ConnectionRequired:
  • Connection name
  • Service Account Key (JSON file) - upload or paste the JSON key file from GCP
Optional Configuration: All of these can be specified in the service account key or overridden here:
  • Default Project ID
  • Billing Project ID
  • Location (e.g., US, EU, asia-northeast1)
  • Maximum Bytes Billed
  • Query Timeout (milliseconds)
  1. Test the connection to verify connectivity
  2. Click Next: Configure Scope to proceed
Connection details - step 1 of the connection wizard

​
Configure Scope for AI-Assisted Modeling

After configuring your connection details, you’ll select which schemas and tables to index for AI-assisted modeling. The Schema Browser lets you browse and select specific tables. Configure scope - select tables for AI indexing
  • Browse schemas on the left, select tables on the right
  • Use Select All to include all tables in a schema, or pick individual tables
  • Check “Do not include any tables for AI-assisted modeling” if you only need the connection for manual queries
These indexing limits apply to AI-assisted model creation:
  • 100 tables per schema for metadata indexing
  • 25 tables or fewer for automated join inference
You can manually write Malloy models for any size dataset. Published models are indexed separately for analysis.
Click Update Connection to save. You’ll see an indexing status page confirming the connection is being indexed: Connection indexing status

​
CLI Option

Use the Credible command-line tool for programmatic connection management and automation.
  1. Install the CLI: 
    npm install -g cred
  2. Login to your organization: 
    cred login <organizationName>
  3. Add a connection: 
    cred add connection <connectionFileName>
    The connection file should be a JSON file containing an array of connection objects. See the CLI reference for detailed connection file formats and examples.

​
Next Steps

After connecting your data, you’ll move to building your model in Cursor:

AI-Assisted Modeling

Create semantic models with AI assistance

Embed Data Files

Include CSV or Parquet files directly in your packages for reference data and lookup tables