Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/google/vscode-bigquery
A Visual Studio Code plugin for running BigQuery queries.
https://github.com/google/vscode-bigquery
bigquery extension sql vscode
Last synced: 4 months ago
JSON representation
A Visual Studio Code plugin for running BigQuery queries.
- Host: GitHub
- URL: https://github.com/google/vscode-bigquery
- Owner: google
- License: apache-2.0
- Archived: true
- Created: 2018-10-16T17:19:35.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-08T04:59:34.000Z (over 1 year ago)
- Last Synced: 2024-09-25T23:03:27.669Z (4 months ago)
- Topics: bigquery, extension, sql, vscode
- Language: TypeScript
- Homepage: https://cloud.google.com/bigquery/
- Size: 207 KB
- Stars: 149
- Watchers: 5
- Forks: 22
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# vscode-bigquery
![BigQuery icon](bigquery-icon.png)
A Visual Studio Code ("VS Code") extension that can query Google Cloud Platform's [BigQuery analytics database](https://cloud.google.com/bigquery/) from, and return results to, your editor. This extension allows you to:
- Write SQL in VS Code and query BigQuery datasets directly
- Create queries from selected text
- Capture results into VS Code window to manipulate them furtherThis extension is great if you're exploring BigQuery and prefer VS Code's editing environment, or for cases where you're writing documentation (hint: use "Run selected text as query") and want to double check that the query is valid.
## Installing
The package will be available on the VS Code Marketplace shortly, but in the meantime, you can install it manually:
1. Download the latest pre-built release here: [vscode-bigquery-0.0.1.vsix](https://github.com/google/vscode-bigquery/releases/download/v0.0.1/vscode-bigquery-0.0.1.vsix)
2. Open the Command Palette in VS Code (Ctrl/Cmd+Shift+P), and type "ext install" -> select "Extension: Install From VSIX..."
3. Navigate to the folder where you saved the `.vsix` file, and select it.
4. Reload VS Code when prompted.## Usage
The BigQuery extension adds a number of commands to the command palette (Cmd/Ctrl+Shift+P).
By default, it will look for your `GOOGLE_APPLICATION_CREDENTIALS` environmental variable (if set) and use the service account described in that JSON file. You can also explicitly set `bigquery.keyFilename` to the path of your [Service Account key file](https://cloud.google.com/docs/authentication/getting-started). Unless necessary, it's recommended that you scope this key to the [`roles.bigquery.user`](https://cloud.google.com/bigquery/docs/access-control#permissions_and_roles) role, which is sufficient for querying and most related tasks.
## Optional Configuration
The extension can be customized by modifying your `settings.json` file. The available configuration options, and their defaults, are below.
```js
"bigquery.keyFilename" = "" // the fully-qualified path to the service account file you downloaded - e.g. '/home/you/mykeyfile-1313ef.json'
"bigquery.projectId" = "" // only needed if your key file is not in JSON format - e.g. 'funny-horse-1234'
"bigquery.email" = "" // only needed if your key file is not in JSON format - e.g. '[email protected]'
"bigquery.useLegacySql" = false // use the legacy SQL language when making queries.
"bigquery.maximumBytesBilled" = null // Unlimited
"bigquery.location" = "US" // Defaults to "US"
"bigquery.outputFormat" = "json" // "json", "csv"
```The majority of these settings are inherited from [`ClientConfig`](https://cloud.google.com/nodejs/docs/reference/bigquery/1.3.x/global#ClientConfig) in the underlying BigQuery client library.
## Contributing
Feature requests are accepted, but please raise an issue describing your feature before sending a PR. This extension focuses on _querying_ BigQuery, rather than dataset- and/or table- level functionality.
This is not an officially supported Google product.
## License
Apache 2.0 licensed. See the LICENSE file for details.