Client Google BigQuery cho Mac

Chọn Phương thức xác thực (Auth Method) và nhập Project ID: là ID, không phải tên hay số của project. Application Default Credentials đọc file do gcloud auth application-default login tạo ra, nên đây là cách gọn nhất khi gcloud đã được thiết lập sẵn. Khóa tài khoản dịch vụ (Service Account Key) nhận một file key .json hoặc nội dung JSON dán vào.

Google Account (OAuth) đăng nhập qua trình duyệt bằng một OAuth client loại desktop mà bạn tạo trong Google Cloud Console. Refresh token được lưu trong Keychain, mỗi OAuth client một token, nên những lần kết nối sau không cần mở trình duyệt. Một OAuth client chỉ đăng nhập một tài khoản Google, nên tài khoản thứ hai cần một client thứ hai hoặc refresh token riêng của tài khoản đó.

Mọi thứ đi qua REST API của BigQuery, nên không có host, port, URL kết nối hay SSH tunnel. Vị trí (Location) đặt processing location được gửi kèm mỗi job. Xem thêm về đăng nhập bằng tài khoản cloud.

Trước khi chạy một query, hãy chọn Dry Run (Cost) trong menu Giải thích (Explain). Kết quả liệt kê số byte query sẽ xử lý và bị tính phí, cờ cache hit và chi phí ước tính bằng đô la Mỹ, còn bản thân query không được chạy.

Sau khi chạy, thanh trạng thái hiển thị số byte đã xử lý, số byte bị tính phí và chi phí ước tính theo giá on-demand, đồng thời đánh dấu khi trúng cache. Để có mức trần cứng, hãy đặt Số byte tính phí tối đa (Max Bytes Billed) trong tab Nâng cao (Advanced) của connection: BigQuery sẽ từ chối job nào bị tính phí vượt mức thay vì chạy nó.

Autocomplete, cách đặt dấu trích dẫn và định dạng đều theo GoogleSQL, với dấu backtick quanh tên table, còn cột STRUCT và ARRAY hiện dưới dạng JSON. Dataset đóng vai trò cơ sở dữ liệu: chúng được liệt kê trong sidebar, ⌘K chuyển giữa chúng, và mỗi tab giữ dataset mà nó được mở trên đó. Job được theo dõi cho tới khi hết query timeout thì bị hủy; khi timeout đặt là Không giới hạn (No limit), TablePro chờ tới khi job xong.

Sửa ô, thêm và xóa dòng đều làm trong data grid. UPDATE và DELETE so khớp dòng theo khóa chính đã khai báo; với table không có khóa chính, chúng so khớp mọi cột trừ cột ARRAY, JSON và GEOGRAPHY, nên các dòng giống hệt nhau sẽ thay đổi cùng lúc. Hãy khai báo PRIMARY KEY (…) NOT ENFORCED để sửa đúng một dòng. Với table có partition, hãy viết UPDATE và DELETE kèm bộ lọc partition trong editor.

DDL chạy từ editor, như CREATE SCHEMA, ALTER TABLE … ADD COLUMN, DROP COLUMN và CREATE OR REPLACE VIEW. Cơ sở dữ liệu mới… (New Database…) tạo dataset bằng CREATE SCHEMA, và table có thể đổi tên từ sidebar. Tab DDL đọc từng định nghĩa từ INFORMATION_SCHEMA.TABLES, còn clustering và partitioning hiện trong mục Indexes.

TablePro không có import cho BigQuery. Export table hoặc kết quả query về máy Mac ra CSV, JSON, SQL, XLSX, Markdown, HTML và XML.

Server-Side Export unload một table bằng EXPORT DATA tới một prefix gs:// ở dạng CSV, Parquet hoặc JSON phân tách theo dòng (newline-delimited JSON), chia thành nhiều phần dưới prefix đó. Thao tác chạy trên connection của bạn với quyền của bạn, hộp thoại chờ tới khi unload xong, và không có file nào được ghi về máy Mac.

Ứng dụng cho iPhone và iPad không có driver Google BigQuery. Connection Google BigQuery đồng bộ từ máy Mac vẫn hiện trong danh sách nhưng không mở được.