

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\$1function\$1name* (*variable1**data\$1type*[, *variable2**data\$1type*] [,...])**  
*ml\$1function\$1name*mendefinisikan nama fungsi, yang dapat digunakan dalam klausa query berikutnya. Masing-masing *variable data\$1type* 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\$1type***  
*data\$1type*menentukan tipe data SQL yang *ml\$1function\$1name* kembali ke kueri sebagai output dari model SageMaker AI.

**PEMBUAT SAGEMAKER '*sagemaker\$1endpoint***  
*sagemaker\$1endpoint*menentukan titik akhir model SageMaker AI.

**PILIH [...] *ml\$1function\$1name*(*expression*) [...]**  
Kueri SELECT yang meneruskan nilai ke variabel fungsi dan model SageMaker AI untuk mengembalikan hasil. *ml\$1function\$1name*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;
```