From 85b49ae40072bf6b618c7bf57cdc3baa2ca0f112 Mon Sep 17 00:00:00 2001 From: Deborah Barnard Date: Thu, 27 Apr 2023 12:06:19 +0100 Subject: [PATCH] release note for 0.226.0 and big query updates --- .../n8n-nodes-base.googlebigquery.md | 98 ++----------------- docs/release-notes.md | 23 ++++- document-templates/release-notes.md | 2 + 3 files changed, 31 insertions(+), 92 deletions(-) diff --git a/docs/integrations/builtin/app-nodes/n8n-nodes-base.googlebigquery.md b/docs/integrations/builtin/app-nodes/n8n-nodes-base.googlebigquery.md index abb406d63..2b36baa49 100644 --- a/docs/integrations/builtin/app-nodes/n8n-nodes-base.googlebigquery.md +++ b/docs/integrations/builtin/app-nodes/n8n-nodes-base.googlebigquery.md @@ -16,98 +16,14 @@ On this page, you'll find a list of operations the Google BigQuery node supports For usage examples and templates to help you get started, take a look at n8n's [Google BigQuery integrations](https://n8n.io/integrations/google-bigquery/){:target="_blank" .external-link} list. -## Basic Operations +## Operations -**Record** +- Execute Query +- Insert -- Create a new record -- Retrieve all records - - - -## Example Usage - -This workflow allows you to send position updates of the ISS every minute to a table in Google BigQuery. You can also find the [workflow](https://n8n.io/workflows/1049) on n8n.io. This example usage workflow uses the following nodes. - -- [Schedule Trigger](/integrations/builtin/core-nodes/n8n-nodes-base.scheduletrigger/) -- [HTTP Request](/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) -- [Set](/integrations/builtin/core-nodes/n8n-nodes-base.set/) -- [Google BigQuery]() - -The final workflow should look like the following image. - -![A workflow with the Google BigQuery node](/_images/integrations/builtin/app-nodes/googlebigquery/workflow.png) - -### 1. Schedule Trigger node - -The Schedule Trigger node will trigger the workflow every minute. - -1. Click on ***Add Cron Time***. -2. Select 'Every Minute' from the ***Mode*** dropdown list. -3. Click on ***Execute Node*** to run the node. - -In the screenshot below, you will notice that the Cron node is configured to trigger the workflow every minute. - -![Using the Cron node to trigger the workflow every minute](/_images/integrations/builtin/app-nodes/googlebigquery/cron_node.png) - -### 2. HTTP Request node (GET) - -This node will make a GET request to the API `https://api.wheretheiss.at/v1/satellites/25544/positions` to fetch the position of the ISS. This information gets passed on to the next node in the workflow. - -1. Enter `https://api.wheretheiss.at/v1/satellites/25544/positions` in the ***URL*** field. -2. Click on the ***Add Parameter*** button in the ***Query Parameters*** section. -3. Enter `timestamps` in the ***Name*** field. -4. Click on the gears icon next to the ***Value*** field and click on ***Add Expression***. -5. Enter the following expression: `{{Date.now()}}`. This expression will return the current timestamp. -6. Click on ***Execute Node*** to run the node. - -In the screenshot below, you will notice that the node makes a GET request to the API and returns the information about the location of the ISS. - -![Using the HTTP Request node to get the information about the location of the ISS](/_images/integrations/builtin/app-nodes/googlebigquery/httprequest_node.png) - -### 3. Set node - -We will use the Set node to ensure that only the data that we set in this node gets passed on to the next nodes in the workflow. - -1. Click on ***Add Value*** and select 'String' from the dropdown list. -2. Enter `name` in the ***Name*** field. -3. Click on the gears icon next to the ***Value*** field and click on ***Add Expression***. -4. Select the following in the ***Variable Selector*** section: Current Node > Input Data > JSON > 0 > name. You can also add the following expression: `{{$json["0"]["name"]}}`. -5. Click on ***Add Value*** and select 'Number' from the dropdown list. -6. Enter `latitude` in the ***Name*** field. -7. Click on the gears icon next to the ***Value*** field and click on ***Add Expression***. -8. Select the following in the ***Variable Selector*** section: Nodes > Input Data > JSON > 0 > latitude. You can also add the following expression: `{{$json["0"]["latitude"]}}`. -9. Click on ***Add Value*** and select 'Number' from the dropdown list. -10. Enter `longitude` in the ***Name*** field. -11. Click on the gears icon next to the ***Value*** field and click on ***Add Expression***. -12. Select the following in the ***Variable Selector*** section: Nodes > Input Data > JSON > 0 > longitude. You can also add the following expression: `{{$json["0"]["longitude"]}}`. -13. Click on ***Add Value*** and select 'Number' from the dropdown list. -14. Enter `timestamp` in the ***Name*** field. -15. Click on the gears icon next to the ***Value*** field and click on ***Add Expression***. -16. Select the following in the ***Variable Selector*** section: Nodes > Input Data > JSON > 0 > timpestamp. You can also add the following expression: `{{$json["0"]["timestamp"]}}`. -17. Toggle ***Keep Only Set*** to `true`. We set this option to true to ensure that only the data that we have set in this node get passed on to the next nodes in the workflow. -18. Click on ***Execute Node*** to run the node. - -In the screenshot below, you will notice that the node uses the data from the previous node and returns the data that we set for the workflow. - -![Using the Set node to set the data](/_images/integrations/builtin/app-nodes/googlebigquery/set_node.png) - -### 4. Google BigQuery node (create: record) - -This node will send the data from the previous node to the `position` table in Google BigQuery. If you have created a table with a different name, use that table instead. - -1. First of all, you'll have to enter credentials for the Google BigQuery node. You can find out how to do that [here](/integrations/builtin/credentials/google/). -2. Select a project from the ***Project ID*** dropdown list. -3. Select a dataset from the ***Dataset ID*** dropdown list. -4. Select the table from `position` from the ***Table ID*** dropdown list. If you created a table with a different name, select that table instead. -5. Enter `name, latitude, longitude, timestamp` in the ***Columns*** field. -6. Click on ***Execute Node*** to run the node. - -In the screenshot below, you will notice that the node sends the data from the previous node to the `position` table in Google BigQuery. - -![Using the Google BigQuery node to create new record](/_images/integrations/builtin/app-nodes/googlebigquery/googlebigquery_node.png) - -!!! note "Activate workflow for production" - This example workflow uses the Cron node, which is a Trigger node. You'll need to save the workflow and then click on the Activate toggle on the top right of the screen to activate the workflow. Your workflow will then be triggered as specified by the settings in the Cron node. +## Related resources +Refer to [Google BigQuery's documentation](https://cloud.google.com/bigquery/docs/reference/rest){:target=_blank .external-link} for more information about the service. + +View [example workflows and related content](https://n8n.io/integrations/google-bigquery/){:target=_blank .external-link} on n8n's website. diff --git a/docs/release-notes.md b/docs/release-notes.md index 0794ff41a..a3fb05136 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -13,12 +13,33 @@ hide: New features and bug fixes for n8n. -You can also view the [Changelog](https://github.com/n8n-io/n8n/blob/master/CHANGELOG.md){:target=_blank .external-link} in the GitHub repository. +You can also view the [Releases](https://github.com/n8n-io/n8n/releases){:target=_blank .external-link} in the GitHub repository. --8<-- "_snippets/self-hosting/installation/latest-next-version.md" --8<-- "_snippets/update-n8n.md" +## n8n@0.226.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@0.225.2...n8n@0.226.0){:target=_blank .external-link} for this version.
+**Release date:** 2023-04-26 + +This release contains new features, node enhancements, and bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases){:target=_blank .external-link} on GitHub. + +### New features + +* A new command to get information about licenses for self-hosted users: + ```sh + n8n license:info + ``` + +### Node enhancements + +* Nodes that use SQL, such as the PostgresSQL node, now have a better SQL editor for writing custom queries. +* An overhaul of the Google BigQuery node to support executing queries, improve the UI making it easier to configure, improve error handling, and fix issues. + ## n8n@0.225.2 View the [commits](https://github.com/n8n-io/n8n/compare/n8n@0.225.1...n8n@0.225.2){:target=_blank .external-link} for this version.
diff --git a/document-templates/release-notes.md b/document-templates/release-notes.md index e86feef3a..e820c7a70 100644 --- a/document-templates/release-notes.md +++ b/document-templates/release-notes.md @@ -20,6 +20,8 @@ View the [commits](