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 User-defined Function descrive AWS Glue i tipi di dati e le operazioni utilizzate nell'utilizzo delle funzioni.

Tipi di dati

UserDefinedFunction struttura

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.

    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.

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

UserDefinedFunctionInput struttura

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.

    La risorsa URIs per la funzione.

Operazioni

CreateUserDefinedFunction azione (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 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.

    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

UpdateUserDefinedFunction azione (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 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.

    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

DeleteUserDefinedFunction azione (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 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.

    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

GetUserDefinedFunction azione (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 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.

    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

GetUserDefinedFunctions azione (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 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.

    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