Looker URI Format

The Uniform Resource Identifier (URI) definition for Looker follows this standard:

Identifier Fragments

• Namespace: looker://{host} OR looker://{host}:{port}
  • Scheme = looker
  • Authority = {host} OR {host}:{port}
• Unique name: {dashboardId}

Dashboard URI Format

• looker://{host}/{dashboardId} OR looker://{host}:{port}/{dashboardId}

Instance URI Format

• looker://{host} OR looker://{host}:{port}

About Adding Port Information to the Authority

Including the port in the URI or not helps Sifflet distinguish port forwarding, Looker Cloud, and self-hosted Looker cases. In practice, follow this rule:

• If you are using Looker Cloud, or port forwarding on a self-hosted Looker instance, or using port 443 on a self-hosted Looker instance, skip the port in the URI and use the format looker://{host}/{dashboardId}
• In other cases, add the port to the URI and use the format looker://{host}:{port}/{dashboardId}

Parameter Limitations

• host identifier must start with a lowercase letter and include only lowercase letters, numbers, dash and dot (regex: [a-z][a-z0-9-.]+)
• port identifier must include numbers only.
• dashboardId identifier covers two different types of ID:
  • “standard” Looker dashboard ID, that is the identifier you find in the URL when navigating to a dashboard on a Looker instance. It is an integer. Ex: 132
  • LookML dashboard ID is the other type of identifier. It is composed of two elements, one of them is the model name and the other one the dashboard name. The ID looks like that: {modelName}::{dashboardName}
    • modelName can include any Unicode character until U+FFFF, except /, ?, *, :, |, ", <, >, and %
    • dashboardName can include lowercase letters, uppercase letters, numbers, dashes and underscores.

Examples

• Cloud instance with “standard” dashboard ID:
  • Dashboard: looker://sifflet.cloud.looker.com/145
  • Instance: looker://sifflet.cloud.looker.com
• Cloud instance with LookML ID:
  • Dashboard: looker://sifflet.cloud.looker.com/myModel::my_dashboard
  • Instance: looker://sifflet.cloud.looker.com
• Self-hosted instance with “standard” dashboard ID:
  • Dashboard: looker://self-hosted.sifflet.com:9999/23
  • Instance: looker://self-hosted.sifflet.com:9999
• Self-hosted instance with LookML ID:
  • Dashboard: looker://self-hosted.sifflet.com:9999/myModel::my_dashboard
  • Instance: looker://self-hosted.sifflet.com:9999
• Self-hosted instance with LookML ID and port forwarding on the Looker server:
  • Dashboard: looker://self-hosted.sifflet.com/myModel::my_dashboard
  • Instance: looker://self-hosted.sifflet.com