

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Gunakan ML dengan sintaks Athena
<a name="ml-syntax"></a>

Klausa `USING EXTERNAL FUNCTION` menentukan ML dengan fungsi Athena atau beberapa fungsi yang dapat dijadikan referensi oleh pernyataan `SELECT` berikutnya dalam kueri. Anda menentukan nama fungsi, nama variabel, dan tipe data untuk variabel dan nilai kembali.

## Sinopsis
<a name="ml-synopsis"></a>

Sintaks berikut menunjukkan klausa `USING EXTERNAL FUNCTION` yang menentukan sebuah ML dengan fungsi Athena.

```
USING EXTERNAL FUNCTION {{ml_function_name}} ({{variable1}} {{data_type}}[, {{variable2}} {{data_type}}][,...])
RETURNS {{data_type}} 
SAGEMAKER '{{sagemaker_endpoint}}'
SELECT {{ml_function_name}}()
```

## Parameter
<a name="udf-parameters"></a>

**MENGGUNAKAN FUNGSI EKSTERNAL {{ml\_function\_name}} ({{variable1}}{{data\_type}}[, {{variable2}}{{data\_type}}] [,...])**  
{{ml\_function\_name}}mendefinisikan nama fungsi, yang dapat digunakan dalam klausa query berikutnya. Masing-masing {{variable data\_type}} menentukan variabel bernama dan tipe data yang sesuai yang diterima model SageMaker AI sebagai input. Tipe data yang ditentukan harus berupa tipe data Athena yang didukung.

**PENGEMBALIAN {{data\_type}}**  
{{data\_type}}menentukan tipe data SQL yang {{ml\_function\_name}} kembali ke kueri sebagai output dari model SageMaker AI.

**PEMBUAT SAGEMAKER '{{sagemaker\_endpoint}}**  
{{sagemaker\_endpoint}}menentukan titik akhir model SageMaker AI.

**PILIH [...] {{ml\_function\_name}}({{expression}}) [...]**  
Kueri SELECT yang meneruskan nilai ke variabel fungsi dan model SageMaker AI untuk mengembalikan hasil. {{ml\_function\_name}}menentukan fungsi didefinisikan sebelumnya dalam query, diikuti oleh {{expression}} yang dievaluasi untuk lulus nilai. Nilai-nilai yang diteruskan dan dihasilkan harus cocok dengan tipe data yang sesuai yang ditentukan untuk fungsi dalam klausa `USING EXTERNAL FUNCTION`.

## Contoh
<a name="ml-examples"></a>

Contoh berikut menunjukkan kueri menggunakan ML dengan Athena.

**Example**  

```
USING EXTERNAL FUNCTION predict_customer_registration(age INTEGER) 
    RETURNS DOUBLE
    SAGEMAKER 'xgboost-2019-09-20-04-49-29-303' 
SELECT predict_customer_registration(age) AS probability_of_enrolling, customer_id 
     FROM "sampledb"."ml_test_dataset" 
     WHERE predict_customer_registration(age) < 0.5;
```