User Guide Getting Started Help Center Documentation Community Training
Looker
  
English
Français
Deutsch
日本語
Sending Data to an Amazon S3 Bucket

Amazon S3 buckets are a common way to store large amounts of data. If you have created an S3 bucket with Amazon, Looker will let you send data to it directly.

You can immediately send data from an Explore, Look, or dashboard to your Amazon S3 bucket using the Send option from the gear menu of an Explore, Look, or dashboard. This lets you send data right away, without setting up a schedule. In the case of an Explore, you can send a query immediately, without having to save the query to a dashboard or a Look.

After choosing Send from the gear menu, choose Amazon S3 in the Where should this data go section. You’ll see the following options:

Naming Your Delivery

Give the content a unique title in the Title field. The title is used in the file name of the data delivery, and in any error emails that are sent to you in case of any problems delivering the data to your Amazon S3 bucket.

Delivering to S3

In Where should this data go, choose Amazon S3. The S3 Details section appears and prompts you for information about your Amazon S3 bucket:

Check out this Community topic for more details about delivering data using an Amazon S3 bucket.

To learn more about other types of data delivery, see the page for each destination option: email, SFTP server, applications using a webhook, or one of several integrated services.

Formatting the Data

In Format data as, choose the format for the data in your delivery.

For dashboards, you can choose:

For Looks and Explores, you can choose:

Applying Filters to the Delivery

If you are delivering a Look or dashboard that has filters, you can filter the results delivered to each set of recipients. For example, you might send regional teams results that are filtered for their states of interest:

Click Filters to see and modify the filters associated with this Look or dashboard for your data delivery. Changing these filter options in the Send or Schedule window does not change the filters in your Look or dashboard.

If you change field names that serve as filters in your Looks or dashboards, be sure to review the Filters section of your scheduled Looks and dashboards and update the filters as needed to reflect your changes. If a scheduled content delivery includes filters that no longer function (for example, if the referenced field has changed), the scheduled delivery could expose unfiltered data.

To make custom deliveries even easier, you can use the matches a user attribute filter option if your Looker admins have configured user-specific values called user attributes. Setting a filter to one of these attributes automatically customizes the results for each user, meaning that you can send customized results to many users even if you select Send only once. You can read more about user attributes here.

Using Advanced Options

The Advanced options section provides additional customization for your delivery. Click the arrow next to Advanced options to expand this menu.

Sending Limits

When sending Looks and Explores, you can limit the size of your delivery. Select one of the following limit options for your data:

If you choose "Results in Table," Looker will obey whatever row limitations you've set up in the saved Look or the Explore. If you choose "All Results," Looker will return all the rows of the query, regardless of any saved Look settings, and regardless of Looker's typical 5,000 row limit. This can be desirable for retrieving very large datasets, but you should use caution to ensure the query is not too large for your database.

Format Options

Apply Visualization Options

For Looks, Explores, and CSV-formatted dashboards, you can configure whether you want the data delivery to use the same options as your visualization:

Formatted Data Values

For Looks, Explores, and the CSV format of dashboards, you can configure the data's formatting:

Single Column Layout

For dashboard deliveries in PDF or Visualization format, you have the option to print your PDF in a single column layout, which displays dashboard tiles in a single vertical column. Check the Use single column layout box to use this option, or leave the box unchecked to show the tiles as they are arranged in the dashboard.

Expand Tables

To display all rows of a data table — rather than just those rows that display in the dashboard tile thumbnail — in a PDF dashboard delivery or download, check the Expand tables box. If you do not see the Expand tables option, talk to your Looker admin about installing the Chromium renderer for your Looker instance.

Paper Size

You have the option to specify the optimal size and orientation of dashboard PDFs by selecting from the Paper size drop-down menu. Large visualizations or groups of overlapping dashboard tiles may need to be resized to fit cleanly on a PDF page. If you do not see the Paper size option, talk to your Looker admin about installing the Chromium renderer for your Looker instance.

Sending Your Content

When you have selected all the options for your delivery, click the Send button to send your content.

Top