API della funzione definita dall'utente - AWS Glue

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

L'API della funzione definita dall'utente descrive i tipi di dati e le operazioni AWS Glue utilizzate per lavorare con le funzioni.

Tipi di dati

Struttura UserDefinedFunction

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.

    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.

    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.

    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.

    Il proprietario della funzione.

  • OwnerType: stringa UTF-8 (valori validi: USER | ROLE | GROUP).

    Il tipo di proprietario.

  • CreateTime: timestamp.

    L'ora in cui è stata creata la funzione.

  • ResourceUris: una matrice di oggetti ResourceUri, non superiore a 1000 strutture.

    Gli URI della risorsa per la funzione.

  • CatalogId: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

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

Struttura UserDefinedFunctionInput

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.

    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.

    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.

    Il proprietario della funzione.

  • OwnerType: stringa UTF-8 (valori validi: USER | ROLE | GROUP).

    Il tipo di proprietario.

  • ResourceUris: una matrice di oggetti ResourceUri, non superiore a 1000 strutture.

    Gli URI della risorsa per la funzione.

Operazioni

Operazione CreateUserDefinedFunction (Python: create_user_defined_function)

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.

    L'ID del catalogo dati in cui creare la funzione. Se non viene fornito, 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.

    Il nome del database del catalogo in cui creare la funzione.

  • FunctionInput: obbligatorio: oggetto 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

Operazione UpdateUserDefinedFunction (Python: update_user_defined_function)

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.

    L'ID del catalogo dati in cui si trova la funzione da aggiornare. Se non viene fornito, 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.

    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.

    Il nome della funzione .

  • FunctionInput: obbligatorio: oggetto UserDefinedFunctionInput.

    Un oggetto FunctionInput che ridefinisce la funzione nel catalogo dati.

Risposta
  • Nessun parametro di risposta.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

Operazione DeleteUserDefinedFunction (Python: delete_user_defined_function)

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.

    L'ID del catalogo dati in cui si trova la funzione da eliminare. Se non viene fornito, 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.

    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.

    Il nome della definizione della funzione da eliminare.

Risposta
  • Nessun parametro di risposta.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

Operazione GetUserDefinedFunction (Python: get_user_defined_function)

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.

    L'ID del catalogo dati in cui si trova la funzione da richiamare. Se non viene fornito, 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.

    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.

    Il nome della funzione .

Risposta
Errori
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

Operazione GetUserDefinedFunctions (Python: get_user_defined_functions)

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.

    L'ID del catalogo dati in cui si trovano le funzioni da recuperare. Se non viene fornito, 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.

    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.

    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.

    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