Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# API della funzione definita dall'utente
<a name="aws-glue-api-catalog-functions"></a>

L'API User-defined Function descrive AWS Glue i tipi di dati e le operazioni utilizzate nell'utilizzo delle funzioni.

## Tipi di dati
<a name="aws-glue-api-catalog-functions-objects"></a>
+ [UserDefinedFunction struttura](#aws-glue-api-catalog-functions-UserDefinedFunction)
+ [UserDefinedFunctionInput struttura](#aws-glue-api-catalog-functions-UserDefinedFunctionInput)

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

Rappresenta l'equivalente di una definizione di funzione Hive definita dall'utente (`UDF`).

**Campi**
+ `FunctionName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della funzione.
+ `DatabaseName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo che contiene la funzione.
+ `ClassName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  La classe Java che contiene il codice della funzione.
+ `OwnerName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il proprietario della funzione.
+ `OwnerType`: stringa UTF-8 (valori validi: `USER` \$1 `ROLE` \$1 `GROUP`).

  Il tipo di proprietario.
+ `CreateTime`: timestamp.

  L'ora in cui è stata creata la funzione.
+ `ResourceUris`: una matrice di oggetti [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri), non superiore a 1000 strutture.

  La risorsa URIs per la funzione.
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui si trova la funzione.

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

Una struttura utilizzata per creare o aggiornare una funzione definita dall'utente.

**Campi**
+ `FunctionName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della funzione.
+ `ClassName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  La classe Java che contiene il codice della funzione.
+ `OwnerName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il proprietario della funzione.
+ `OwnerType`: stringa UTF-8 (valori validi: `USER` \$1 `ROLE` \$1 `GROUP`).

  Il tipo di proprietario.
+ `ResourceUris`: una matrice di oggetti [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri), non superiore a 1000 strutture.

  La risorsa URIs per la funzione.

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

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

Crea una nuova definizione di funzione nel catalogo dati.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui creare la funzione. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell'account. AWS 
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui creare la funzione.
+ `FunctionInput` - *obbligatorio:* oggetto [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput).

  Un oggetto `FunctionInput` che definisce la funzione da creare nel catalogo dati.

**Risposta**
+ *Nessun parametro di risposta.*

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

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

Aggiorna una definizione di funzione esistente nel catalogo dati.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui si trova la funzione da aggiornare. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell'account. AWS 
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui si trova la funzione da aggiornare.
+ `FunctionName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della funzione.
+ `FunctionInput` - *obbligatorio:* oggetto [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput).

  Un oggetto `FunctionInput` che ridefinisce la funzione nel catalogo dati.

**Risposta**
+ *Nessun parametro di risposta.*

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

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

Elimina una definizione di funzione esistente dal catalogo dati.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui si trova la funzione da eliminare. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell'account AWS .
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui si trova la funzione.
+ `FunctionName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della definizione della funzione da eliminare.

**Risposta**
+ *Nessun parametro di risposta.*

**Errori**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

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

Richiama una definizione di funzione specificata dal catalogo dati.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui si trova la funzione da richiamare. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell'account AWS .
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui si trova la funzione.
+ `FunctionName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della funzione.

**Risposta**
+ `UserDefinedFunction`: un oggetto [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction).

  La definizione di funzione richiesta.

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

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

Richiama definizioni di funzione multiple dal catalogo dati.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui si trovano le funzioni da recuperare. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell'account AWS .
+ `DatabaseName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui si trovano le funzioni. Se non ne viene fornito nessuno, verranno restituite le funzioni di tutti i database del catalogo.
+ `Pattern` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Una stringa di modello nome-funzione facoltativa che filtra le definizioni di funzione restituite.
+ `NextToken`: stringa UTF-8.

  Un token di continuazione, se si tratta di una chiamata di continuazione.
+ `MaxResults` – Numero (intero), non inferiore a 1 o superiore a 100.

  Il numero massimo di funzioni da restituire in una risposta.

**Risposta**
+ `UserDefinedFunctions`: una matrice di oggetti [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction).

  Un elenco di definizioni di funzione richieste.
+ `NextToken`: stringa UTF-8.

  Un token di continuazione, se l'elenco di funzioni restituite non include l'ultima funzione richiesta.

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