bqls for Visual Studio Code

April 13, 2025 ยท View on GitHub

VSCode extension for bqls: BigQuery Language Server

Features

Execute query

Command Palette (Ctrl+Shift+P) -> bqls: Execute Query

or

Code Action (Ctrl+.) -> Execute Query

image

Save result

local CSV or Google Spreadsheet

Table Explorer

image

Hover infomation

Column

image

Function

image

etc.

  • Format
  • Definition jump
  • Auto Complete

Install

prerequisite: install bqls

download from https://github.com/kitagry/bqls/releases/tag/v0.4.0 and place it into PATH

or else, build from source

CC=clang CXX=clang++ go install github.com/kitagry/bqls@v0.4.0

check

bqls -version

prerequisite: install gcloud SDK

https://cloud.google.com/sdk/docs/install

gcloud auth application-default login

install extension

git clone https://github.com/yokomotod/bqls-vscode.git
cd bqls-vscode

npm install
npx vsce package

code --install-extension bqls-vscode-0.1.0.vsix

bqls support status

  • โœ… textDocument/formatting
    • format SQL by zetasql.FormatSQL
  • โœ… textDocument/hover
    • show table/column metadata
    • show function document
  • โœ… textDocument/definition
    • show table information
  • ๐Ÿ”บ textDocument/codeAction
    • โœ… bqls.executeQuery
    • โŒ bqls.listJobHistories
  • workspace/executeCommand
  • โŒ workspace/didChangeConfiguration

based on https://github.com/kitagry/bqls/tree/main#supported-protocol