Các hàm do người dùng xác định trong Python W3schools

Viết hàm trong Python

4 giờ

61. 4K

Hàm do người dùng xác định (UDF) cho phép bạn tạo một hàm bằng cách sử dụng biểu thức SQL hoặc mã JavaScript. UDF chấp nhận các cột đầu vào, thực hiện các hành động trên đầu vào và trả về kết quả của các hành động đó dưới dạng giá trị

Bạn có thể xác định UDF là liên tục hoặc tạm thời. Bạn có thể sử dụng lại các UDF liên tục trên nhiều truy vấn, trong khi các UDF tạm thời chỉ tồn tại trong phạm vi của một truy vấn

Để tạo UDF, hãy sử dụng câu lệnh

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Để biết thông tin về UDF trong SQL kế thừa, hãy xem Hàm do người dùng xác định trong SQL kế thừa

SQL UDF

Ví dụ sau tạo một UDF SQL tạm thời có tên là

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE TEMP FUNCTION AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

SELECT
  val, AddFourAndDivide(val, 2)
FROM
  UNNEST([2,3,5,8]) AS val;

Ví dụ này tạo ra đầu ra sau

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

Ví dụ tiếp theo tạo chức năng tương tự như một UDF liên tục

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Vì UDF này là liên tục, nên bạn phải chỉ định tập dữ liệu cho hàm (

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Các tham số SQL UDF được tạo mẫu

Một tham số có loại bằng

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

• Nếu nhiều tham số có loại

  CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
  RETURNS FLOAT64
  AS (
    (x + 4) / y
  );
  

  01 thì BigQuery không thực thi bất kỳ mối quan hệ loại nào giữa các đối số này
• Kiểu trả về của hàm không được là

  CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
  RETURNS FLOAT64
  AS (
    (x + 4) / y
  );
  

  01. Nó phải được bỏ qua, có nghĩa là được xác định tự động dựa trên

  CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
  RETURNS FLOAT64
  AS (
    (x + 4) / y
  );
  

  04 hoặc một loại rõ ràng
• Truyền các đối số hàm của các loại không tương thích với định nghĩa hàm sẽ dẫn đến lỗi khi gọi

Ví dụ sau đây cho thấy một SQL UDF sử dụng tham số templated

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Ví dụ này tạo ra đầu ra sau

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Ví dụ tiếp theo sử dụng tham số templated để trả về phần tử cuối cùng của một mảng thuộc bất kỳ loại nào

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Ví dụ này tạo ra đầu ra sau

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Truy vấn con vô hướng

SQL UDF có thể trả về giá trị của truy vấn con vô hướng. Một truy vấn con vô hướng phải chọn một cột duy nhất

Ví dụ sau đây cho thấy một SQL UDF sử dụng truy vấn con vô hướng để đếm số lượng người dùng có độ tuổi nhất định trong bảng người dùng

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Ví dụ này tạo ra đầu ra sau

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Dự án mặc định trong các biểu thức SQL

Trong nội dung của SQL UDF, mọi tham chiếu đến các thực thể BigQuery, chẳng hạn như bảng hoặc dạng xem, phải bao gồm ID dự án, trừ khi thực thể nằm trong cùng một dự án chạy câu lệnh

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Ví dụ, hãy xem xét tuyên bố sau

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

Nếu bạn chạy câu lệnh này từ ________ 106 và _______ 107 tồn tại trong ________ 106, thì câu lệnh thành công. Tuy nhiên, nếu bạn chạy câu lệnh này từ một dự án khác, thì câu lệnh sẽ không thành công. Để sửa lỗi, hãy bao gồm ID dự án trong tham chiếu bảng

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

Bạn cũng có thể tham chiếu một thực thể trong một dự án hoặc tập dữ liệu khác với dự án hoặc tập dữ liệu mà bạn tạo hàm

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

JavaScript UDF

JavaScript UDF cho phép bạn gọi mã được viết bằng JavaScript từ truy vấn SQL

Ví dụ sau hiển thị JavaScript UDF. Mã JavaScript được trích dẫn trong một chuỗi thô

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

Ví dụ này tạo ra đầu ra sau

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

Ví dụ tiếp theo tính tổng giá trị của tất cả các trường có tên

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

Ví dụ tạo ra đầu ra sau

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

Các loại dữ liệu JavaScript UDF được hỗ trợ

Một số loại SQL có ánh xạ trực tiếp tới các loại JavaScript, nhưng những loại khác thì không. BigQuery đại diện cho các loại theo cách sau

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Vì JavaScript không hỗ trợ loại số nguyên 64 bit, nên

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

BigQuery không hỗ trợ

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Nếu giá trị trả về của JavaScript UDF là một

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Quy tắc trích dẫn

Bạn phải đặt mã JavaScript trong dấu ngoặc kép. Đối với các đoạn mã đơn giản, một dòng, bạn có thể sử dụng một chuỗi trích dẫn tiêu chuẩn

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

Ví dụ này tạo ra đầu ra sau

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

Trong trường hợp đoạn mã chứa dấu ngoặc kép hoặc bao gồm nhiều dòng, hãy sử dụng khối dấu ngoặc kép

+-----+-----+
| val | f0_ |
+-----+-----+
|   2 | 3.0 |
|   3 | 3.5 |
|   5 | 4.5 |
|   8 | 6.0 |
+-----+-----+

Ví dụ này tạo ra đầu ra sau

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Bao gồm các thư viện JavaScript

Bạn có thể mở rộng UDF JavaScript của mình bằng phần

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Trong ví dụ trước, mã trong

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Các phương pháp hay nhất cho JavaScript UDF

Lọc trước đầu vào của bạn

Nếu thông tin đầu vào của bạn có thể dễ dàng được lọc xuống trước khi được chuyển đến JavaScript UDF, thì truy vấn của bạn có thể sẽ nhanh hơn và rẻ hơn

Tránh trạng thái có thể thay đổi liên tục

Không lưu trữ hoặc truy cập trạng thái có thể thay đổi qua lệnh gọi JavaScript UDF. Ví dụ: tránh mẫu sau

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Sử dụng bộ nhớ hiệu quả

Môi trường xử lý JavaScript có giới hạn bộ nhớ khả dụng cho mỗi truy vấn. Các truy vấn JavaScript UDF tích lũy quá nhiều trạng thái cục bộ có thể không thành công do cạn kiệt bộ nhớ

UDF được ủy quyền

Các chức năng được ủy quyền cho phép bạn chia sẻ kết quả truy vấn với những người dùng hoặc nhóm cụ thể mà không cấp cho những người dùng hoặc nhóm đó quyền truy cập vào các bảng bên dưới. Ví dụ: một hàm được ủy quyền có thể tính toán tổng hợp trên dữ liệu hoặc tra cứu giá trị bảng và sử dụng giá trị đó trong tính toán

Để biết thêm thông tin, hãy xem Tạo chức năng được ủy quyền

Thêm mô tả vào UDF

Để thêm mô tả vào UDF, hãy làm theo các bước sau

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

Các chức năng do cộng đồng đóng góp

Các UDF do cộng đồng đóng góp có sẵn trong bộ dữ liệu công khai

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

CREATE FUNCTION mydataset.AddFourAndDivide(x INT64, y INT64)
RETURNS FLOAT64
AS (
  (x + 4) / y
);

người dùng là gì

Làm thế nào bạn sẽ viết một người dùng

Chúng ta có thể tạo người dùng không

4 loại hàm trong Python là gì?