Opaque URI (opaqueuri)

[ 1 Description ] [ 2 How does it work in the search window? ] [ 3 How does it work in LINQ? ]

Description

You can apply this operation either as a Filter or Create column operation:

Filter	Retrieves only opaque URIs from a specified field.
Create column	Creates a Boolean column that shows true if a given URI is opaque.

Opaque URIs differ from absolute URIs in that they don't describe a path to a resource. A typical example of opaque URI is a mailto URI (mailto:a@b.com)

How does it work in the search window?

Select Filter / Create column in the search window toolbar, then select the Opaque URI operation. You need to specify one argument:

Argument	Data type

Argument	Data type
URI ^mandatory	string

If you use the Create column operation, the data type of the values in the new column is boolean (true or false).

Example

In the demo.ecommerce.data table, we want to get only the events where the URIs in the referralUri column are opaque. To do it, we will apply a Filter using the Opaque URI operation.

The arguments needed for the filter are:

URI - referralUri column

Click Filter data. Since there is no opaque URIs in the referralUri column, you will see the following result:

To add a new Boolean column that shows true when the URIs in the referralUri column are opaque, click Create column and follow the same steps.

How does it work in LINQ?

Use the operator where... to apply the Filter operation and select... as... to apply the Create column operation. This is the syntax for the Opaque URI operation:

opaqueuri(string)

Examples

You can copy the following LINQ script and try the above example on the demo.ecommerce.data table:

from demo.ecommerce.data
  where opaqueuri(referralUri)

And this is the same example using the Create column operation:

from demo.ecommerce.data
  select opaqueuri(referralUri) as opaque_uris