Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

D toc

D s ed


D s conntype
is a web analytics service offered by Google that tracks and reports website traffic. For more information, see

Limitations and Requirements

D s conn req sql


NOTE: Most interactions with the Google Analytics datastore are formed as custom SQL queries. More information on syntax and examples is provided below.

  • OAuth 2.0 authentication is required. 

    • An OAuth 2.0 web client must be available for use in the

      D s webapp

    • You cannot create OAuth 2.0 connections via API.
  • The following schema is supported: UniversalAnalytics.


    Tip: This schema was previously called GoogleAnalytics by the driver vendor.

  • D s conntype
     allows up to 10 metrics and seven dimensions in a single query.

    • When issuing a query that selects all columns, only the default Metric columns are selected for tables with more than 10 Metrics.

    • The default Dimensions are used unless you explicitly select other dimension columns.

  • All reports in

    D s conntype
     must cover a specific date range.

    • The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset.

    • To override this behavior, the values can be set directly in the query.

Create Connection

D s webapp

When you create the connection, please review the following properties and specify them accordingly:

Connection PropertyDescription
View Id

Unique identifier of the view


Tip: To acquire your View Id, login to

D s conntype
and navigate to your site data. Click the name of your site in the top menu bar. The identifiers for the available views are listed as numeric values in the right column.

Connect String Options

The following is the default connect string option:

Code Block
  • The first option sets the connection timeout in seconds. Setting this value to 0 disables timeouts.
  • For more information on the second option, see below.
OAuth2 Client

The client is displayed.


NOTE: When you create the connection in this window, you must click Authenticate, which authenticates to the app. This step is required.

Default Column Data Type InferenceLeave this value as Enabled.

For more information, see the driver documentation

Connect String Options

Enhanced SQL

By default, the following connect string options is included. This option enables an enhanced form of SQL support for the connection.

Code Block

When this feature is enabled:

  • In-memory processing that is handled by default in the querying application (
    D s webapp
    ) is passed to Google Analytics for processing. 
  • This feature enables the use of advanced SQL expressions, such as the use of more predicates, joins, and aggregations.

For more information on enhanced SQL for Google Analytics, see

Data Type Conversions

For more information, see the driver documentation

Example queries:

To import data from Google Analytics, you typically create a custom SQL SELECT statement. Example:

Code Block
SELECT distinct Date, Sessions, NewUsers, BounceRate, PageviewsPerSession, AvgSessionDuration, Browser, FROM GoogleAnalytics.Traffic where StartDate = '90DaysAgo' and EndDate ='Today'


NOTE: The distinct keyword is currently required in default configuration when referencing specific values in a where clause. Optionally, you can enable the use of enhanced SQL for this connection, which eliminates the need for the distinct keyword. See "Connect String Options" above.

  • Do not apply quotes, double-quotes, or brackets around field or table values.
  • Literal values should be in single quotes.
  • StartDate and EndDate parameters can be used to specify a date range.

For more information:

D s also