

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

# API Fungsi yang ditentukan pengguna
<a name="aws-glue-api-catalog-functions"></a>

User-defined Function API menjelaskan tipe AWS Glue data dan operasi yang digunakan dalam bekerja dengan fungsi.

## Jenis Data
<a name="aws-glue-api-catalog-functions-objects"></a>
+ [UserDefinedFunction struktur](#aws-glue-api-catalog-functions-UserDefinedFunction)
+ [UserDefinedFunctionInput struktur](#aws-glue-api-catalog-functions-UserDefinedFunctionInput)

## UserDefinedFunction struktur
<a name="aws-glue-api-catalog-functions-UserDefinedFunction"></a>

Merepresentasikan definisi fungsi yang ditetapkan pengguna Hive (`UDF`) yang setara.

**Bidang**
+ `FunctionName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama fungsi.
+ `DatabaseName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data katalog yang berisi fungsi.
+ `ClassName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Kelas Java yang berisi kode fungsi.
+ `OwnerName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pemilik fungsi.
+ `OwnerType` – String UTF-8 (nilai yang valid: `USER` \$1 `ROLE` \$1 `GROUP`).

  Jenis pemilik.
+ `CreateTime` — Stempel waktu.

  Waktu saat fungsi dibuat.
+ `ResourceUris` — Susunan objek [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri), tidak lebih dari 1000 struktur.

  Sumber daya URIs untuk fungsi tersebut.
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data tempat fungsi berada.

## UserDefinedFunctionInput struktur
<a name="aws-glue-api-catalog-functions-UserDefinedFunctionInput"></a>

Struktur yang digunakan untuk membuat atau memperbarui sebuah fungsi yang ditetapkan pengguna.

**Bidang**
+ `FunctionName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama fungsi.
+ `ClassName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Kelas Java yang berisi kode fungsi.
+ `OwnerName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pemilik fungsi.
+ `OwnerType` – String UTF-8 (nilai yang valid: `USER` \$1 `ROLE` \$1 `GROUP`).

  Jenis pemilik.
+ `ResourceUris` — Susunan objek [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri), tidak lebih dari 1000 struktur.

  Sumber daya URIs untuk fungsi tersebut.

## Operasi
<a name="aws-glue-api-catalog-functions-actions"></a>
+ [CreateUserDefinedFunction tindakan (Python: create\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-CreateUserDefinedFunction)
+ [UpdateUserDefinedFunction tindakan (Python: update\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-UpdateUserDefinedFunction)
+ [DeleteUserDefinedFunction tindakan (Python: delete\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-DeleteUserDefinedFunction)
+ [GetUserDefinedFunction tindakan (Python: get\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-GetUserDefinedFunction)
+ [GetUserDefinedFunctions tindakan (Python: get\$1user\$1defined\$1functions)](#aws-glue-api-catalog-functions-GetUserDefinedFunctions)

## CreateUserDefinedFunction tindakan (Python: create\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-CreateUserDefinedFunction"></a>

Menciptakan sebuah definisi fungsi baru dalam Katalog Data.

**Permintaan**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID Katalog Data tempat fungsi dibuat. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data katalog tempat fungsi dibuat.
+ `FunctionInput` — *Wajib:* Sebuah objek [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput).

  Sebuah objek `FunctionInput` yang mendefinisikan fungsi yang akan dibuat dalam Katalog Data.

**Respons**
+ *Tidak ada parameter Respons.*

**Kesalahan**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`

## UpdateUserDefinedFunction tindakan (Python: update\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-UpdateUserDefinedFunction"></a>

Memperbarui definisi fungsi yang ada dalam Katalog Data.

**Permintaan**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID Katalog Data di mana fungsi yang akan diperbarui berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data katalog di mana fungsi yang akan diperbarui berada.
+ `FunctionName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama fungsi.
+ `FunctionInput` — *Wajib:* Sebuah objek [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput).

  Sebuah objek `FunctionInput` yang mendefinisikan kembali fungsi yang ada dalam Katalog Data.

**Respons**
+ *Tidak ada parameter Respons.*

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeleteUserDefinedFunction tindakan (Python: delete\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-DeleteUserDefinedFunction"></a>

Menghapus sebuah definisi fungsi yang ada dari Katalog Data.

**Permintaan**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data di mana fungsi yang akan dihapus berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data katalog tempat fungsi berada.
+ `FunctionName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama definisi fungsi yang akan dihapus.

**Respons**
+ *Tidak ada parameter Respons.*

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetUserDefinedFunction tindakan (Python: get\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-GetUserDefinedFunction"></a>

Mengambil definisi fungsi yang ditentukan dari Katalog Data.

**Permintaan**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data di mana fungsi yang akan diambil berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data katalog tempat fungsi berada.
+ `FunctionName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama fungsi.

**Respons**
+ `UserDefinedFunction` — Sebuah objek [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction).

  Definisi fungsi yang diminta.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## GetUserDefinedFunctions tindakan (Python: get\$1user\$1defined\$1functions)
<a name="aws-glue-api-catalog-functions-GetUserDefinedFunctions"></a>

Mengambil beberapa definisi fungsi dari Katalog Data.

**Permintaan**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data di mana fungsi yang akan diambil berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `DatabaseName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data katalog di mana fungsi berada. Jika tidak ada yang disediakan, maka fungsi dari semua basis data di katalog akan dikembalikan.
+ `Pattern` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  String pola fungsi-nama opsional yang menyaring definisi fungsi yang dikembalikan.
+ `NextToken` – String UTF-8.

  Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.

  Jumlah maksimum fungsi yang akan dikembalikan dalam satu respons.

**Respons**
+ `UserDefinedFunctions` – Susunan objek [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction).

  Daftar definisi fungsi yang diminta.
+ `NextToken` – String UTF-8.

  Sebuah token kelanjutan, jika daftar fungsi yang dikembalikan tidak termasuk fungsi yang diminta terakhir.

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`