# Omni Docs: Admin ## Admin - [Omni administration](https://docs.omni.co/administration/index.md): Manage users, security, billing, and more in your Omni instance ### Connect data - [Connect data](https://docs.omni.co/connect-data/index.md): Connect your data warehouse or database to Omni and configure connection settings - [Troubleshooting connection issues](https://docs.omni.co/connect-data/troubleshooting.md): Diagnose and resolve common database connection errors in Omni, including cross-database queries, timeouts, and authentication. #### Connect databases - [Connect a database](https://docs.omni.co/connect-data/setup/index.md): Connect your data warehouse or database to Omni - [Creating quick database connections with connection strings](https://docs.omni.co/connect-data/setup/quick-connect.md): Create database connections quickly by pasting a connection URI - [Connecting Amazon Athena to Omni as a data source](https://docs.omni.co/connect-data/setup/athena.md): Learn how to create an access key or IAM role and connect your Amazon Athena data source to Omni. - [Connecting ClickHouse to Omni](https://docs.omni.co/connect-data/setup/clickhouse.md): Learn how to retrieve connection details and connect your ClickHouse database to Omni. - [Connecting Databricks to Omni](https://docs.omni.co/connect-data/setup/databricks.md): Learn how to generate credentials, retrieve connection details, and connect your Databricks workspace to Omni. - [Connecting Exasol to Omni](https://docs.omni.co/connect-data/setup/exasol.md): Learn how to create a database user, grant permissions, and connect your Exasol database to Omni. - [Connecting MariaDB to Omni](https://docs.omni.co/connect-data/setup/mariadb.md): Learn how to create a database user, grant permissions, and connect your MariaDB database to Omni. - [Connecting Microsoft SQL Server to Omni](https://docs.omni.co/connect-data/setup/microsoftsql.md): Learn how to retrieve connection details and connect your Microsoft SQL Server database to Omni. - [Connecting MotherDuck to Omni](https://docs.omni.co/connect-data/setup/motherduck.md): Learn how to create an access token and connect your MotherDuck database to Omni. - [Connecting MySQL to Omni](https://docs.omni.co/connect-data/setup/mysql.md): Learn how to create a database user, grant permissions, and connect your MySQL database to Omni. - [Connecting Postgres to Omni](https://docs.omni.co/connect-data/setup/postgres.md): Learn how to create a database user, grant permissions, and connect your Postgres database to Omni. - [Connecting Amazon Redshift to Omni](https://docs.omni.co/connect-data/setup/redshift.md): Learn how to create a database user, grant permissions, and connect your Amazon Redshift data warehouse to Omni. - [Connecting Snowflake to Omni](https://docs.omni.co/connect-data/setup/snowflake.md): Learn how to create a database user, grant permissions, and connect your Snowflake data warehouse to Omni. - [Connecting Starburst Galaxy to Omni](https://docs.omni.co/connect-data/setup/starburst-galaxy.md): Learn how to create a dedicated Starburst Galaxy user, grant privileges, and connect your Galaxy cluster to Omni. - [Connecting StarRocks to Omni](https://docs.omni.co/connect-data/setup/starrocks.md): Learn how to create a database user, grant permissions, and connect your StarRocks database to Omni. ##### BigQuery - [Connecting Google BigQuery to Omni with a service account](https://docs.omni.co/connect-data/setup/bigquery.md): Connect your Google BigQuery project to Omni using a service account and private key. - [Connecting Google BigQuery to Omni with workload identity federation](https://docs.omni.co/connect-data/setup/bigquery-workload-identity.md): Connect BigQuery to Omni using workload identity federation — no service account key to store, upload, or rotate. #### Configure OAuth - [OAuth for database connections](https://docs.omni.co/connect-data/oauth/index.md): Authenticate individual users against your database with OAuth, enforcing database-level permissions in Omni. - [Configuring native OAuth for Databricks databases](https://docs.omni.co/connect-data/oauth/databricks.md): Configure native Databricks OAuth, allowing each Omni user to authenticate with their Databricks credentials when running queries. ##### Snowflake - [OAuth for Snowflake connections](https://docs.omni.co/connect-data/oauth/snowflake/index.md): Authenticate individual users against your Snowflake database with OAuth, enforcing database-level permissions in Omni. - [Configuring native OAuth for Snowflake databases](https://docs.omni.co/connect-data/oauth/snowflake/native.md): Configure native Snowflake OAuth, allowing each Omni user to authenticate with their Snowflake credentials when running queries. - [Configuring Snowflake External OAuth with Microsoft Entra ID](https://docs.omni.co/connect-data/oauth/snowflake/external-entra.md): Configure Snowflake External OAuth to authenticate users through Microsoft Entra ID (Azure AD). - [Configuring Snowflake External OAuth with Okta](https://docs.omni.co/connect-data/oauth/snowflake/external-okta.md): Configure Snowflake External OAuth to authenticate users through Okta. - [Troubleshooting Snowflake OAuth](https://docs.omni.co/connect-data/oauth/snowflake/troubleshooting.md): Diagnose and resolve common issues with Omni's Snowflake OAuth integration. #### Manage connections - [Restricting connection schemas](https://docs.omni.co/connect-data/schema-restriction.md): Limit which schemas are included in your Omni model to improve performance and control model scope. - [Defining view name generation for database connections](https://docs.omni.co/connect-data/view-name-generation.md): Control how Omni generates view names from database tables by always including catalog and schema prefixes. - [Understanding timezone conversion & connection settings](https://docs.omni.co/connect-data/timezones.md): Learn how connection settings impact timezone conversion in your data, how to determine the converting timezone, and how to prevent conversion. - [Archiving (deleting) connections](https://docs.omni.co/connect-data/archive-connection.md): Archive a database connection to permanently remove it from your Omni organization, including its associated models and content. #### PrivateLink & SSH - [Connect to private databases with AWS PrivateLink](https://docs.omni.co/connect-data/aws-privatelink.md): Set up AWS PrivateLink to connect Omni to databases in private VPCs using encrypted VPC endpoint connections. - [Connect to private databases with Azure PrivateLink](https://docs.omni.co/connect-data/azure-privatelink.md): Set up Azure Private Link to connect Omni to databases in private Azure networks using encrypted private endpoint connections. - [Connect to Azure SQL Database with Azure Private Link](https://docs.omni.co/connect-data/azure-sql-privatelink.md): Connect Omni to an Azure SQL Database over a private network using an Azure Private Link service. - [Connect to ClickHouse Cloud with AWS PrivateLink](https://docs.omni.co/connect-data/clickhouse-privatelink.md): Connect Omni to a ClickHouse Cloud service on AWS over a private network using a VPC endpoint. - [Connecting to Databricks using AWS or Azure PrivateLink](https://docs.omni.co/connect-data/databricks-privatelink.md): Connect Omni to a Databricks workspace over a private network using AWS PrivateLink or Azure Private Link endpoints. - [Connect to Redshift with AWS PrivateLink](https://docs.omni.co/connect-data/redshift-privatelink.md): Connect to Redshift Provisioned clusters or Redshift Serverless workgroups in AWS using PrivateLink - [Connecting to Snowflake using AWS or Azure PrivateLink](https://docs.omni.co/connect-data/snowflake-privatelink.md): Connect Omni to your Snowflake instance over a private network using AWS PrivateLink or Azure Private Link endpoints. - [Connecting databases using SSH](https://docs.omni.co/connect-data/ssh-tunnels.md): SSH tunnels allow you to connect to a database in a private network or add another layer of network encryption. #### Advanced configuration - [Dynamic connection environments](https://docs.omni.co/connect-data/dynamic-environments.md): Allow users to switch database environments while modeling or building analyses. - [User-selected connection environments](https://docs.omni.co/connect-data/user-selected-environments.md): Let users pick which database connection environment their queries, dashboards, and schedules run against. - [Offloading schemas](https://docs.omni.co/connect-data/offloading-schemas.md): Improve model performance by deferring the load of large or infrequently used schemas – like dbt virtual schemas – until they’re needed. - [Pulling Databricks metrics and metrics views into Omni](https://docs.omni.co/connect-data/databricks-unity-catalog-integration.md): Sync Databricks Unity Catalog metric views into Omni to query, visualize, and explore governed metrics. ##### Snowflake semantic views - [Getting started with Snowflake semantic views](https://docs.omni.co/connect-data/snowflake-semantic-views/index.md): Import Snowflake semantic views as topics and query them in Omni. Requirements and setup steps. - [Querying Snowflake semantic view topics](https://docs.omni.co/connect-data/snowflake-semantic-views/querying.md): Where imported Snowflake semantic view topics appear in Omni and how to query them in workbooks. - [Pushing Omni topics to Snowflake](https://docs.omni.co/connect-data/snowflake-semantic-views/push-to-snowflake.md): Use the omni-to-snowflake-semantic-view agent skill to convert an Omni topic into a Snowflake semantic view definition. - [Snowflake semantic view limitations](https://docs.omni.co/connect-data/snowflake-semantic-views/limitations.md): What Omni doesn't import from a Snowflake semantic view, and what imports in a fixed way. ###### Sync to Omni - [Syncing Snowflake semantic views](https://docs.omni.co/connect-data/snowflake-semantic-views/sync/trigger-sync.md): Run a schema refresh to import Snowflake semantic views as topics, and learn what Omni creates for each one. - [Snowflake semantic view metadata reference](https://docs.omni.co/connect-data/snowflake-semantic-views/sync/metadata-reference.md): A complete list of what each part of a Snowflake semantic view definition becomes in the topic Omni generates from it. - [Snowflake semantic view example](https://docs.omni.co/connect-data/snowflake-semantic-views/sync/example.md): A Snowflake semantic view definition and the Omni topic generated from it, covering comments, synonyms, filters, and AI instructions. ### Manage users and permissions - [Managing users](https://docs.omni.co/administration/users/index.md): Invite, monitor, and manage users in your Omni organization. - [Inviting users](https://docs.omni.co/administration/users/invite.md): Send invitations, manage invitation requests, and re-invite users with expired invitations. - [Managing your account settings](https://docs.omni.co/administration/users/your-account.md): Configure your personal Omni settings, including appearance, query timezone, and personal API tokens. - [Email-only users](https://docs.omni.co/administration/users/email-only.md): Learn how email-only users work in Omni, including how they're created, managed, and used with deliveries and embedded analytics. - [Managing a user's settings](https://docs.omni.co/administration/users/settings.md): Learn how to access the settings for individual users and test data access through impersonation. - [Testing access grants and permissions with user impersonation](https://docs.omni.co/administration/users/impersonate.md): Use Omni's impersonation feature to view the application as another user and verify that access grants and permissions work correctly. - [User groups](https://docs.omni.co/administration/users/groups.md): Assign permissions to users in bulk with user groups. - [User attributes](https://docs.omni.co/administration/users/attributes.md): Utilize user-specific variables to create dynamic content and control data access. - [Revoking user memberships](https://docs.omni.co/administration/users/delete.md): Learn how to permanently revoke a user's membership in Omni, including what happens to their content and deliveries. #### Assign permissions - [Managing data access with connection permissions](https://docs.omni.co/administration/users/permissions.md): Assign and test database connection, data model, and content-level permissions to control user access across your Omni instance.as asd as das dw - [Defining custom model roles](https://docs.omni.co/administration/users/custom-roles.md): Define custom roles with specific permission restrictions that can be assigned to users, groups, and connections. - [Common user access scenarios](https://docs.omni.co/administration/users/permissions-scenarios.md): Learn how to implement user permissions to achieve different levels of access in Omni. - [Connection and model permissions reference](https://docs.omni.co/administration/users/permissions-reference.md): A detailed reference of all connection and model role permissions in Omni, covering document, query, and modeling capabilities. - [Troubleshooting user permissions](https://docs.omni.co/administration/users/permissions-troubleshooting.md): Troubleshoot the most common permission issues. ### Manage organization - [Organization settings](https://docs.omni.co/administration/settings.md): Configure organization-wide settings in Omni, including user access defaults, content visibility, and support access controls. - [Authentication settings](https://docs.omni.co/administration/settings/authentication.md): Configure general authentication behavior, SAML, and OIDC for your Omni organization. - [App settings](https://docs.omni.co/administration/settings/app-policy.md): Control whether your organization can use Apps and which external hosts those apps are allowed to load resources from. - [Localization settings](https://docs.omni.co/administration/localization.md): Configure language settings at the organization and user levels. - [Content permission settings](https://docs.omni.co/administration/content-permissions.md): Manage the default content permissions for your organization in **Settings > Content permissions**. - [Managing billing & invoices](https://docs.omni.co/administration/billing.md): View your organization's Omni billing information & invoices. - [Canceling long-running and hanging queries](https://docs.omni.co/administration/running-queries.md): Stop queries that hang or run longer than expected, saving your database resources. #### AI settings - [AI Hub](https://docs.omni.co/administration/ai-hub.md): Monitor how your organization uses Omni AI — adoption, answer quality, and credit usage — from a single admin space. - [AI Feature settings](https://docs.omni.co/ai/settings/features.md): Enable and disable individual AI features in your Omni organization. - [AI MCP Server settings](https://docs.omni.co/ai/settings/mcp.md): Enable and disable individual MCP Server tools in your Omni organization. - [Managing AI credit usage](https://docs.omni.co/ai/settings/usage.md): View and manage AI credit usage for your Omni organization. - [AI branding](https://docs.omni.co/ai/settings/branding.md): Customize the appearance of the AI chat interface in your Omni organization. ##### Model providers - [Bring Your Own Key (BYOK)](https://docs.omni.co/ai/settings/model-providers/index.md): Configure a custom AI model provider for your Omni organization. - [Using Databricks Genie for Omni AI](https://docs.omni.co/ai/settings/model-providers/databricks-genie.md): Configure Databricks Genie as an AI model provider in Omni using your own serving endpoints. - [Using Google Gemini Enterprise Agent Platform (Vertex AI) for Omni AI](https://docs.omni.co/ai/settings/model-providers/google-vertex-ai.md): Configure Google Vertex AI as an AI model provider in Omni. - [Using a custom OpenAI model for Omni AI](https://docs.omni.co/ai/settings/model-providers/openai.md): Use custom model identifiers with OpenAI to connect Omni to Ollama, Azure OpenAI, fine-tuned models, and more. - [Using Snowflake Cortex for Omni AI](https://docs.omni.co/ai/settings/model-providers/snowflake-cortex.md): Configure Snowflake Cortex as an AI model provider in Omni. #### Appearance - [Emoji settings](https://docs.omni.co/administration/settings/emoji.md): Configure emoji mode for query tabs and manage custom emoji at the organization level. - [Customizing your organization's navigation sidebar](https://docs.omni.co/administration/settings/sidebar.md): Build a custom sidebar for your organization with a visual, drag-and-drop editor and live preview. ##### Chart palettes - [Managing chart palettes](https://docs.omni.co/administration/chart-palettes/index.md): Predefined color palettes help you apply consistent colors across charts, workbooks, and dashboards. - [Setting a default chart palette for your organization](https://docs.omni.co/administration/chart-palettes/default.md): Set a default chart color palette for your Omni organization, applied automatically to new charts based on chart type and data. - [Managing custom chart palettes](https://docs.omni.co/administration/chart-palettes/custom.md): Create custom palettes with your company colors, ensuring your workbooks, charts, and dashboards are always consistent and on-brand. - [Built-in palette color reference](https://docs.omni.co/administration/chart-palettes/omni.md): The color values for the built-in palettes are provided as a reference for creating your own palette variations. ##### Themes - [Application and document theme settings](https://docs.omni.co/administration/themes/index.md): Manage application and document themes in Omni to customize branding, colors, fonts, and visual style across your organization. - [Application theme settings](https://docs.omni.co/administration/themes/application.md): Configure application theme settings in Omni, including navigation colors, fonts, dark mode, branding, and theme import/export. - [Document theme settings](https://docs.omni.co/administration/themes/documents.md): Customize the look and feel of content in your Omni instance. ### Identity Providers - [Set up Identity Providers (IdP) for authentication](https://docs.omni.co/administration/authentication/index.md): Configure SSO, SAML, or OIDC for your Omni organization - [Managing users with Google Workspace SAML](https://docs.omni.co/administration/authentication/google-workspace.md): Integrate Omni with Google Workspace for user authentication via the SAML protocol. - [Configuring OIDC authentication](https://docs.omni.co/administration/authentication/oidc.md): Configure OpenID Connect (OIDC) authentication for your Omni organization. - [SAML and SCIM troubleshooting](https://docs.omni.co/administration/authentication/troubleshooting.md): Common issues and solutions for SAML and SCIM authentication in Omni. #### Microsoft Entra (Azure AD) - [Microsoft Entra authentication](https://docs.omni.co/administration/authentication/entra/index.md): Connect Omni to Microsoft Entra for secure SAML single sign-on and automated user provisioning. - [Microsoft Entra SAML authentication](https://docs.omni.co/administration/authentication/entra/saml.md): Configure service provider (SP)-initiated SAML authentication between Microsoft Entra and Omni. - [Auto-provisioning Omni users with Microsoft Entra SCIM](https://docs.omni.co/administration/authentication/entra/scim.md): Automatically manage Omni accounts for your users with Microsoft Entra SCIM provisioning. - [Syncing Microsoft Entra user attributes to Omni with SCIM](https://docs.omni.co/administration/authentication/entra/user-attributes.md): Sync user attributes from Microsoft Entra to Omni via SCIM. #### Okta - [Okta authentication](https://docs.omni.co/administration/authentication/okta/index.md): Connect Omni to Okta for secure SAML single sign-on and automated user provisioning. - [Configuring Okta SAML authentication](https://docs.omni.co/administration/authentication/okta/saml.md): Configure service provider (SP)-initiated SAML authentication between Okta and Omni. - [Auto-provisioning Omni users with Okta SCIM](https://docs.omni.co/administration/authentication/okta/scim.md): Automatically manage Omni accounts for your users with Okta SCIM provisioning. - [Syncing Okta user attributes to Omni with SCIM](https://docs.omni.co/administration/authentication/okta/user-attributes.md): Sync user attributes from Okta to Omni via SCIM. #### Rippling - [Rippling authentication](https://docs.omni.co/administration/authentication/rippling/index.md): Connect Omni to Rippling for secure SAML single sign-on and automated user provisioning. - [Configuring Rippling SAML SSO](https://docs.omni.co/administration/authentication/rippling/saml.md): Integrate Omni with Rippling for user authentication via the SAML protocol. - [Auto-provisioning Omni users with Rippling SCIM](https://docs.omni.co/administration/authentication/rippling/scim.md): Automatically manage Omni accounts for your users with Rippling SCIM provisioning. ### Security - [Omni product & system security](https://docs.omni.co/administration/security/index.md): Learn more about how Omni keeps your data secure. - [Omni supported cloud regions](https://docs.omni.co/administration/security/cloud-regions.md): Select a cloud region for your Omni instance, which determines where customer content will be stored and processed. - [Omni information security program](https://docs.omni.co/administration/security/information-security-program.md): Omni maintains written policies and procedures designed to ensure the security of our employees, partners, and customers. - [AI data security](https://docs.omni.co/ai/security.md): Learn how Omni handles your data when you use AI tools. - [Allowlisting Omni's IP addresses](https://docs.omni.co/administration/security/omni-ip-addresses.md): Find the static IP addresses for your Omni environment and configure your firewall or allowlist for secure database connections. - [Vulnerability disclosure policy](https://docs.omni.co/administration/security/vulnerability-disclosure.md): Learn how Omni handles vulnerabilities and how to report them to our security team. ### Monitor Omni - [Usage analytics](https://docs.omni.co/administration/analytics.md): Gain insight into how Omni is being used in your organization. #### Audit logs - [Audit logs](https://docs.omni.co/administration/audit-logs/index.md): Set up audit logging in Omni to track user activity with structured event logs delivered to Amazon S3, Google Cloud Storage, or Azure Blob Storage. - [Using Amazon S3 for Omni audit logs](https://docs.omni.co/administration/audit-logs/amazon-s3.md): Track Omni user activity in your instance with structured logs, accessible in an Amazon S3 bucket. - [Using Google Cloud Storage for Omni audit logs](https://docs.omni.co/administration/audit-logs/google-cloud-storage.md): Configure Google Cloud Storage as the destination for your Omni audit logs to track user activity with structured event data. - [Using Azure Blob Storage for Omni audit logs](https://docs.omni.co/administration/audit-logs/azure-blob-storage.md): Track Omni user activity in your instance with structured logs, accessible in an Azure Blob Storage container via a Microsoft Entra application or a SAS token. - [Audit log event types](https://docs.omni.co/administration/audit-logs/event-types.md): Reference for all audit log event types and their payload fields.