Versions Compared

Key

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

BigQuery registrations should be straightforward.

Table of Contents

General Tab

...

Info
Using the Keyboard combination "CTRL + SHIFT + P", you may quickly access Server Properties and edit Tab Coloring options.

...

Image Added

Anchor
filteroptions
filteroptions
Using Filters Options in Registration (Filter Tab)

Edit the Server Properties, to use FILTER options for a Server in Aqua Data Studio:

...

  • Filter Objects: Allows the user to specify the main schema browser filter for object types, on whether to include or exclude all.
  • Include Objects: A list of objects to include after the main filter is applied.
  • Exclude Objects: A list of objects to exclude after the main filter is applied.

Google BigQuery Filter.pngImage RemovedImage Added

Features

  • You can Create, Edit, or Delete Object Folders. Default Folders are Tables, Views.
  • Sometimes you would like to view only specific Schemas. Use options to INCLUDE or EXCLUDE all Schemas and Folders.
  • Enter the Schema or Folder name in the specified text area and click OK. The current Connection will be terminated. Reconnect to see the changes.
  • Filters are case-sensitive.
  • Filter Projects works on the list of projects inside the "Projects" folder.
  • Filter Folders works on the list of folders inside a particular dataset. Example folders: Tables, Views.
  • Object Folder filter works on individual folders inside a particular dataset. The user can define filters for each of the Tables, Views folders.

...

If your intention is to show only the tables that start with XXPKD, then you need to change your main filter to "Exclude All", and the secondary filter to "+XXPKD*". Note the "+" in front of the XXPKD pattern. Also, note that the filter pattern is case-sensitive.

Google BigQuery Folder Filter.pngImage RemovedImage Added

The filter shown below is set to exclude all projects except those that start with "aq". This is similar to the above example where all schemas, except the XXPKD schema, are excluded. Then, there is an "Object Folder" filter on the Tables folder, which excludes everything except those that start with "forum".Google BigQuery Exclude Folder FIlter.pngImage Removed

Image Added

Anchor
advancedproperties
advancedproperties
Using Advanced Properties (Advanced Tab)

Edit the Server Properties to use Advanced Properties in Aqua Data Studio:

...

  • Transaction Isolation Level: Support for setting Transaction Isolation Level - TRANSACTION_NONE - A constant indicating that transactions are not supported.
    - TRANSACTION_READ_COMMITTED - A constant indicating that dirty reads are prevented; non-repeatable reads and phantom reads can occur.
    - TRANSACTION_READ_UNCOMMITTED - A constant indicating that dirty reads, non-repeatable reads, and phantom reads can occur.
    - TRANSACTION_REPEATABLE_READ - A constant indicating that dirty reads and non-repeatable reads are prevented; phantom reads can occur.
    - TRANSACTION_SERIALIZABLE - A constant indicating that dirty reads, non-repeatable reads, and phantom reads are prevented.
  • JDBC Escape Processing: Allows JDBC driver to perform escape sequence before sending the SQL code to the server.
  • Display System Folders: Allows to show/hide System Tables in Tables.
  • Always Display Column Name in Results: Allows to show/hide column names in query results.
  • Enable DB Filters for Query Window: Enables/Disables db filters for query windows using this connection.
  • Only Display Databases that User has Access to: Displays only the databases the current user (from the Login Name on the General tab) has access to within the schema browser.
  • Fetch Size: Determines the Fetch Size (number of rows physically retrieved from the database at one time by the JDBC driver).
  • Connections Pooled: Enables connection pooling. Read more about connection pooling here.
  • Force Auto-Commit: When this option is selected, it sets auto-commit to TRUE for any Query Window to this server and disables the icons on the toolbar.
  • List of Additional Project IDs: Specify the project ID of shared datasets.
  • Destination Table - Project ID: Specify the project ID for destination table.
  • Destination Table - Dataset ID: Specify the dataset ID for destination table.
  • Destination Table - Table ID: Specify the table ID which should work as a destination table.
  • Destination Table - Write Preference: Specify the write preference on the resultant table.
    - Write if empty - Writes the data if the table already exists and contains data otherwise returns an error.
    - Append to table - Appends the data to the table if the table already exists. 
    - Overwrite table - Overwrites the data to the table if the table already exists. 

  • Destination Table - Results Size - Allow Large Results: Allows you to create large result tables randomly for the selected destination table. 

  • Destination Table - Results Size - Flatten Results: Allows you to flatten all nested and repeated fields in the single query results.

  • Query Caching - Use Cached Results: Allows you to use results from a previously executed query as long as the referenced tables are not modified. You can cache results for approximately 24 hours. The results of the executed query will not be cached if the destination table is selected.  
  • SQL Version - Use Legacy SQL: Allows you to run the query using Legacy SQL.
  • Data Warehouse Mode: Read Only or Read/Write.
  • Data Warehouse "Read Only" Warning Message: Allows you to set a customized warning message when "Read Only" mode is selected.
  • Object Folder Display: [Default], [Name], [Schema].[Name] or [Name]([Schema]) sets how the Schemas will be displayed.
  • Dataset Folder Grouping: Default, Yes or No. Dataset Folder Grouping makes finding tables much easier because it groups them instead of showing each object individually.
Info
Using the drop-down at the bottom of the Advanced Tab, quickly change your Object Display in the Server Browser. Also, if the 'Destination Table - Result Size - Allow Large Results' is checked, then it is must specify the first three options in the Query Options section.

...

Image Added

Anchor
serverpermissions
serverpermissions
Server Permissions (Permissions Tab)

  Edit the Permissions in Server Properties in Aqua Data Studio:

...

  • Control Statement execution and Properties of the Query Analyzer and Visual Editing.

Google BigQuery Permissions.pngImage RemovedImage Added

Info
Table Data Editor, SQL Debugger, Update, Delete, and Truncate options of Query Analyzer are not supported for Google BigQuery.

Anchor
serverscripts
serverscripts
Server Scripts (Script Tab)

  Edit Scripts in Server Properties in Aqua Data Studio:

...

With scripts in the Script Tab of a Server, you can enter an SQL Script that is executed each time a new connection is established.

Script for SQL Version - Using Legacy SQL

Google BigQuery Script.pngImage Removed

SQL Version - Without Using Legacy SQL

...


Image Added



Image Added


Anchor
servershellscripts
servershellscripts
Shell Scripts (FluidShell Tab)

  Edit Shell Scripts in Server Properties in Aqua Data Studio:

...

  • Enter a FluidShell Script that is executed each time a new FluidShell connection is established.
  • This allows the user to cd (change directory) for a server connection. (Example: cd /scripts)

...

Image Added

Anchor
connectionmonitor
connectionmonitor
Server Connections (Connection Monitor Tab)

Enable the connection monitor to start an application thread that monitors the status of the connection associated with the Query Window.
With the connection monitor, you can:

...

For more information, see Connection Monitor.
Google BigQuery Connection Monitor.pngImage Removed Image Added