Chuyển tới nội dung chính
Trang được dịch

Trang này được dịch từ tiếng Anh với sự hỗ trợ của AI. Nếu hai bản có chỗ khác nhau, hãy lấy phiên bản tiếng Anh làm chuẩn.

UNSET

Xóa một biến phiên, hoặc xóa cấu hình runtime đã đặt bằng SET cho phiên hiện tại. Có từ StackQL v1.0 trở đi.

Xem thêm:
[SET] [ Biến phiên ] [ Phiên provider ]


Cú pháp​

unsetStatement::=

UNSETSESSIONvariableNameconfigurationPath','variableNameconfigurationPath';'

 
 

UNSET [ SESSION ] <target> [, <target> ...];

target
Bất kỳ đích nào mà SET chấp nhận: một tên biến thông thường hoặc đặt trong dấu ngoặc kép, hoặc một đường dẫn cấu hình đặt trong dấu ngoặc kép và có tiền tố dấu đô la.

SESSION
Không bắt buộc, và là phạm vi duy nhất hiện có: UNSET SESSION name và UNSET name là cùng một câu lệnh, vì mọi biến và thiết lập cấu hình đều thuộc về phiên hiện tại. UNSET GLOBAL bị từ chối với lỗi configuration scope "global" is not supported; use SESSION.

UNSET name tương đương với SET name = DEFAULT. Các đích trong một danh sách được xóa theo thứ tự, và việc xóa một tên chưa được đặt không phải là lỗi. Việc giải tham chiếu một biến sau khi biến đó đã được xóa sẽ thất bại trước khi bất kỳ yêu cầu nào tới provider được gửi đi.

ĐíchTác dụng
nameXóa biến phiên.
"$.auth.<provider>.<field>"Xóa trường đó khỏi ngữ cảnh xác thực phiên của provider. Giá trị có hiệu lực trước khi ghi đè không được khôi phục.
"$.providers.<alias>"Xóa liên kết bí danh provider.
"$.secrets.<name>"Xóa bí mật khỏi kho của phiên. Với một kho lưu trữ lâu dài của hệ điều hành, thao tác này xóa giá trị đã lưu.
"$.secret_store"Hủy liên kết kho hiện tại và bắt đầu với bộ nhớ phiên trống. Các giá trị đã được lưu lâu dài trong kho của hệ điều hành không bị xóa.

Ví dụ​

Xóa một biến​

Biến được xóa khỏi phiên, nên truy vấn trong khối chú thích sẽ thất bại với lỗi variable "$region" is not defined thay vì chạy với một giá trị lỗi thời hoặc trống. Đặt lại tên này để dùng lại.

SET region = 'ap-southeast-2';
UNSET region;

/*
SELECT name FROM aws.s3.buckets WHERE region = $region;
-- FAILS with variable "$region" is not defined
*/

Xóa nhiều đích​

Một câu lệnh có thể xóa cùng lúc cả biến và đường dẫn cấu hình, và các đích được xử lý theo thứ tự. Ở đây, một biến thông thường, một biến có tên chứa dấu chấm và một ghi đè thông tin xác thực được xóa trong cùng một danh sách.

UNSET region, "providers.saved", "$.auth.github.credentialsenvvar";

Ghi rõ phạm vi phiên​

Hai câu lệnh này có cùng tác dụng: SESSION chỉ định phạm vi duy nhất hiện có. Dạng tường minh phù hợp với các tập lệnh cũng chạy trên những cơ sở dữ liệu phân biệt trạng thái phiên với trạng thái toàn cục. Câu lệnh trong khối chú thích thất bại vì không tồn tại trạng thái dùng chung nào.

UNSET region;
UNSET SESSION region;

/*
UNSET GLOBAL region;
-- FAILS with configuration scope "global" is not supported; use SESSION
*/

Xóa một ghi đè thông tin xác thực​

Trường đã đặt trước đó bằng SET "$.auth.github.credentialsenvvar" được xóa khỏi ngữ cảnh xác thực phiên của provider GitHub, và các trường khác của ngữ cảnh đó không bị ảnh hưởng. Giá trị có hiệu lực trước khi ghi đè không được khôi phục, vì vậy hãy đặt lại trường này nếu provider vẫn cần nó.

UNSET "$.auth.github.credentialsenvvar";

Xóa một bí danh provider và bí mật của nó​

Bí danh production đã được liên kết bằng SET "$.providers.production" và tham chiếu, thông qua auth_secret, tới một bí mật được lưu tại $.secrets.production. Việc xóa cả hai trong một câu lệnh sẽ hủy liên kết, nên production.s3.buckets không còn là một quan hệ hợp lệ, đồng thời xóa bí mật khỏi kho của phiên. SESSION ở đây là không bắt buộc, như ở mọi nơi khác.

UNSET SESSION "$.providers.production", "$.secrets.production";