API Sessioni interattive

• Struttura sessione

• SessionCommand struttura

• Struttura istruzione

• StatementOutput struttura

• StatementOutputData struttura

• ConnectionsList struttura

Campi

• Id— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  L'ID della sessione.

• CreatedOn: timestamp.

  La data e l'ora di creazione della sessione.

• Status— UTF-8 stringa (valori validi: PROVISIONING | READY | FAILED | | TIMEOUT STOPPING |STOPPED).

  Lo stato della sessione.

• ErrorMessage: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a URI address multi-line string pattern.

  Il messaggio di errore visualizzato durante la sessione.

• Description: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a URI address multi-line string pattern.

  La descrizione della sessione.

• Role— UTF-8 stringa, lunga non meno di 20 o più di 2048 byte, corrispondente a. Custom string pattern #51

  Il nome o l'Amazon Resource Name (ARN) del ruolo IAM associato alla sessione.

• Command: un oggetto SessionCommand.

  Il comando Object.see. SessionCommand

• DefaultArguments: una matrice di mappe con coppie chiave-valore, non superiore alle 75 coppie.

  Ogni chiave è una UTF-8 stringa, lunga non meno di 1 o più di 128 byte, che corrisponde a. Custom string pattern #52

  Ogni valore è una UTF-8 stringa, lunga non più di 4096 byte, corrispondente a. URI address multi-line string pattern

  Una matrice della mappa di coppie chiave-valore. Il massimo è 75 coppie.

• Connections: un oggetto ConnectionsList.

  Il numero di connessioni utilizzate per la sessione.

• Progress: numero (doppio).

  L'avanzamento dell'esecuzione del codice della sessione.

• MaxCapacity: numero (doppio).

  Il numero di unità di elaborazione AWS Glue dati (DPU) che possono essere allocate durante l'esecuzione del processo. Una DPU è una misura relativa della potenza di elaborazione ed è costituita da 4 vCPU di capacità di elaborazione e 16 GB di memoria.

• SecurityConfiguration— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Il nome della SecurityConfiguration struttura da utilizzare con la sessione.

• GlueVersion— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Custom string pattern #45

  La AWS Glue versione determina le versioni di Apache Spark e Python supportate. AWS Glue GlueVersion Deve essere maggiore di 2.0.

• DataAccessId— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 36 byte.

  L'ID di accesso ai dati della sessione.

• PartitionId— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 36 byte.

  L'ID di partizione della sessione.

• NumberOfWorkers: numero (intero).

  Il numero di dipendenti di uno specifico WorkerType da utilizzare per la sessione.

• WorkerType— UTF-8 stringa (valori validi: Standard="" | G.1X="" | G.2X="" | G.025X="" | | G.4X="" G.8X="" |Z.2X="").

  Il tipo di worker predefinito allocato quando viene eseguita una sessione. Accetta un valore di G.1X, G.2X, G.4X o G.8X per le sessioni Spark. Accetta il valore Z.2X per le sessioni Ray.

• CompletedOn: timestamp.

  La data e ora in cui questa sessione è stata completata.

• ExecutionTime: numero (doppio).

  Il tempo totale di esecuzione della sessione.

• DPUSeconds: numero (doppio).

  Le DPU consumate dalla sessione (formula: ExecutionTime * MaxCapacity).

• IdleTimeout: numero (intero).

  Il numero di minuti di inattività prima del timeout della sessione.

• ProfileName— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Il nome di un profilo di AWS Glue utilizzo associato alla sessione.

• SessionType— UTF-8 stringa (valori validi: LIVY="" |SPARK_CONNECT="").

  Il tipo di sessione.

Campi

• Name— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Specifica il nome di. SessionCommand Può essere 'glueetl' o 'gluestreaming'.

• PythonVersion— UTF-8 stringa, corrispondente a. Custom string pattern #46

  Specifica la versione di Python. La versione Python indica la versione supportata per i processi di tipo Spark.

Campi

• Id: numero (intero).

  L'ID della dichiarazione.

• Code— UTF-8 stringa.

  Il codice di esecuzione della dichiarazione.

• State— UTF-8 stringa (valori validi: WAITING | RUNNING | AVAILABLE | CANCELLING | CANCELLED |ERROR).

  Lo stato mentre viene eseguita la richiesta.

• Output: un oggetto StatementOutput.

  L'output in JSON.

• Progress: numero (doppio).

  L'avanzamento dell'esecuzione del codice.

• StartedOn: numero (lungo).

  L'ora e la data unix in cui è stata avviata la definizione del processo.

• CompletedOn: numero (lungo).

  L'ora e la data unix in cui è stata completata la definizione del processo.

Campi

• Data: un oggetto StatementOutputData.

  L'output dell'esecuzione del codice.

• ExecutionCount: numero (intero).

  Il numero di esecuzioni dell'output.

• Status— UTF-8 stringa (valori validi: WAITING | RUNNING | AVAILABLE | CANCELLING | CANCELLED |ERROR).

  Lo stato dell'output di esecuzione del codice.

• ErrorName— UTF-8 stringa.

  Il nome dell'errore nell'output.

• ErrorValue— UTF-8 corda.

  Il valore dell'errore dell'output.

• Traceback— Una serie di UTF-8 stringhe.

  L'analisi dell'output.

Campi

• TextPlain— UTF-8 corda.

  L'output dell'esecuzione del codice in formato testo.

Campi

• Connections— Una matrice di UTF-8 stringhe, non più di 1000 stringhe.

  Un elenco di connessioni utilizzate dal processo.

• CreateSession azione (Python: create_session)

• StopSession azione (Python: stop_session)

• DeleteSession azione (Python: delete_session)

• GetSession azione (Python: get_session)

• ListSessions azione (Python: list_sessions)

• RunStatement azione (Python: run_statement)

• CancelStatement azione (Python: cancel_statement)

• GetStatement azione (Python: get_statement)

• ListStatements azione (Python: list_statements)

• GetGlueIdentityCenterConfiguration azione (Python: get_glue_identity_center_configuration)

• UpdateGlueIdentityCenterConfiguration azione (Python: update_glue_identity_center_configuration)

• CreateGlueIdentityCenterConfiguration azione (Python: create_glue_identity_center_configuration)

• DeleteGlueIdentityCenterConfiguration azione (Python: delete_glue_identity_center_configuration)

Richiesta

Richiedere la creazione di una nuova sessione.

• Id— Obbligatoria: UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  L'ID della richiesta della sessione.

• Description: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a URI address multi-line string pattern.

  La descrizione della sessione.

• Role— UTF-8 Obbligatoria: stringa, lunga non meno di 20 o più di 2048 byte, corrispondente a. Custom string pattern #51

  L'ARN del ruolo IAM

• Command - obbligatorio: un oggetto SessionCommand.

  Il SessionCommand che esegue questo lavoro.

• Timeout: numero (intero), almeno 1.

  Il numero di minuti prima che la sessione scada. Il valore predefinito per i processi Spark ETL è 48 ore (2.880 minuti). Consulta la documentazione per altri tipi di processo.

• IdleTimeout: numero (intero), almeno 1.

  Il numero di minuti di inattività prima del timeout della sessione. L'impostazione predefinita per i processi ETL di Spark è il valore di timeout. Consulta la documentazione per altri tipi di processo.

• DefaultArguments: una matrice di mappe con coppie chiave-valore, non superiore alle 75 coppie.

  Ogni chiave è una UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente al. Custom string pattern #52

  Ogni valore è una UTF-8 stringa, lunga non più di 4096 byte, corrispondente a. URI address multi-line string pattern

  Una matrice della mappa di coppie chiave-valore. Il massimo è 75 coppie.

• Connections: un oggetto ConnectionsList.

  Il numero di connessioni da utilizzare per la sessione.

• MaxCapacity: numero (doppio).

  Il numero di unità di elaborazione AWS Glue dati (DPU) che possono essere allocate durante l'esecuzione del processo. Una DPU è una misura relativa della potenza di elaborazione ed è costituita da 4 vCPU di capacità di elaborazione e 16 GB di memoria.

• NumberOfWorkers: numero (intero).

  Il numero di dipendenti di uno specifico WorkerType da utilizzare per la sessione.

• WorkerType— UTF-8 stringa (valori validi: Standard="" | | G.1X="" | G.2X="" | G.025X="" | G.4X="" G.8X="" |Z.2X="").

  Il tipo di worker predefinito allocato quando viene eseguito un processo. Accetta un valore pari a G.1X G.2X, G.4X, o G.8X per i job Spark. Accetta il valore Z.2X per i notebook Ray.

  • Per il tipo di worker G.1X, ciascun worker si mappa a 1 DPU (4 vCPU, 16 GB di memoria) con disco da 94 GB e fornisce 1 esecutore per worker. Questi tipi di worker sono raccomandati per carichi di lavoro come trasformazioni di dati, join e query, in quanto offrono un modo scalabile ed economico per eseguire la maggior parte dei processi.

  • Per il tipo di worker G.2X, ciascun worker si mappa a 2 DPU (8 vCPU, 32 GB di memoria) con disco da 138 GB e fornisce 1 esecutore per worker. Questi tipi di worker sono raccomandati per carichi di lavoro come trasformazioni di dati, join e query, in quanto offrono un modo scalabile ed economico per eseguire la maggior parte dei processi.

  • Per il tipo di worker G.4X, ciascun worker si mappa a 4 DPU (16 vCPU, 64 GB di memoria) con disco da 256 GB e fornisce 1 esecutore per worker. Questi tipi di worker sono raccomandati per i processi i cui carichi di lavoro contengono trasformazioni, aggregazioni, join e query con i requisiti più elevati. Questo tipo di lavoratore è disponibile solo per i job Spark ETL della AWS Glue versione 3.0 o successiva AWS nelle seguenti regioni: Stati Uniti orientali (Ohio), Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Asia Pacifico (Singapore), Asia Pacifico (Sydney), Asia Pacifico (Tokyo), Canada (Centrale), Europa (Francoforte), Europa (Irlanda) ed Europa (Stoccolma).

  • Per il tipo di worker G.8X, ciascun worker si mappa a 8 DPU (32 vCPU, 128 GB di memoria) con disco da 512 GB e fornisce 1 esecutore per worker. Questi tipi di worker sono raccomandati per i processi i cui carichi di lavoro contengono trasformazioni, aggregazioni, join e query con i requisiti più elevati. Questo tipo di lavoratore è disponibile solo per i job Spark ETL AWS Glue versione 3.0 o successiva, nelle stesse AWS regioni supportate per il tipo di G.4X lavoratore.

  • Per il tipo di Z.2X lavoratore, ogni lavoratore esegue il mapping su 2 M-DPU (8 vCPU, 64 GB di memoria) con disco da 128 GB e fornisce fino a 8 Ray worker in base all'autoscaler.

• SecurityConfiguration— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Il nome della SecurityConfiguration struttura da utilizzare con la sessione

• GlueVersion— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Custom string pattern #45

  La AWS Glue versione determina le versioni di Apache Spark e Python supportate. AWS Glue GlueVersion Deve essere maggiore di 2.0.

• DataAccessId— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 36 byte.

  L'ID di accesso ai dati della sessione.

• PartitionId— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 36 byte.

  L'ID di partizione della sessione.

• Tags: una matrice di mappe con coppie chiave-valore, non superiore alle 50 coppie.

  Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.

  Ogni valore è una UTF-8 stringa, lunga non più di 256 byte.

  La mappa delle coppie di valori chiave (tag) appartenenti alla sessione.

• RequestOrigin— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #52

  L'origine della richiesta.

• ProfileName— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Il nome di un profilo di AWS Glue utilizzo associato alla sessione.

• SessionType— UTF-8 stringa (valori validi: LIVY="" |SPARK_CONNECT="").

  Il tipo di sessione da creare.

Risposta

• Session: un oggetto Sessione.

  Restituisce l'oggetto di sessione nella risposta.

Errori

• AccessDeniedException

• IdempotentParameterMismatchException

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• ValidationException

• AlreadyExistsException

• ResourceNumberLimitExceededException

• OperationNotSupportedException

Richiesta

• Id— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  L'ID della sessione da interrompere.

• RequestOrigin— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #52

  L'origine della richiesta.

Risposta

• Id— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Restituisce l'ID della sessione interrotta.

Errori

• AccessDeniedException

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• IllegalSessionStateException

• ConcurrentModificationException

Richiesta

• Id— Obbligatoria: UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  L'ID della sessione da eliminare.

• RequestOrigin— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #52

  Il nome dell'origine della richiesta di eliminazione della sessione.

Risposta

• Id— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Restituisce l'ID della sessione eliminata.

Errori

• AccessDeniedException

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• IllegalSessionStateException

• ConcurrentModificationException

Richiesta

• Id— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  L'ID della sessione.

• RequestOrigin— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #52

  L'origine della richiesta.

Risposta

• Session: un oggetto Sessione.

  Salva l'oggetto di sessione restituito nella risposta.

Errori

• AccessDeniedException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

Richiesta

• NextToken— UTF-8 stringa lunga non più di 400000 byte.

  Il token per il successivo set di risultati oppure null se non ci sono altri risultati.

• MaxResults: numero (intero), non inferiore a 1 o superiore a 1.000.

  Il numero massimo di risultati.

• Tags: una matrice di mappe con coppie chiave-valore, non superiore alle 50 coppie.

  Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.

  Ogni valore è una UTF-8 stringa, lunga non più di 256 byte.

  Tag appartenenti alla sessione.

• RequestOrigin— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #52

  L'origine della richiesta.

Risposta

• Ids— Una serie di UTF-8 stringhe.

  Restituisce l'ID della sessione.

• Sessions: una matrice di oggetti Sessione.

  Restituisce l'oggetto di sessione.

• NextToken— UTF-8 stringa lunga non più di 400000 byte.

  Il token per il successivo set di risultati oppure null se non ci sono altri risultati.

Errori

• AccessDeniedException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

Richiesta

• SessionId— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  L'ID di sessione dell'istruzione da eseguire.

• Code— Obbligatoria: UTF-8 stringa, lunga non più di 68000 byte.

  Il codice dell'istruzione da eseguire.

• RequestOrigin— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #52

  L'origine della richiesta.

Risposta

• Id: numero (intero).

  Restituisce l'ID dell'istruzione che è stata eseguita.

Errori

• EntityNotFoundException

• AccessDeniedException

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• ValidationException

• ResourceNumberLimitExceededException

• OperationNotSupportedException

• SessionBusyException

• IllegalSessionStateException

Richiesta

• SessionId— Obbligatoria: UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  L'ID di sessione dell'istruzione da annullare.

• Id - obbligatorio: numero (intero).

  L'ID dell'istruzione da annullare.

• RequestOrigin— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #52

  L'origine della richiesta di annullare l'istruzione.

Risposta

• Nessun parametro di risposta.

Errori

• AccessDeniedException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• IllegalSessionStateException

Richiesta

• SessionId— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  L'ID sessione dell'istruzione.

• Id - obbligatorio: numero (intero).

  L'ID dell'istruzione.

• RequestOrigin— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #52

  L'origine della richiesta.

Risposta

• Statement: un oggetto Dichiarazione.

  Restituisce l'istruzione.

Errori

• AccessDeniedException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• IllegalSessionStateException

Richiesta

• SessionId— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  L'ID sessione delle istruzioni.

• RequestOrigin— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #52

  L'origine della richiesta di elencare le istruzioni.

• NextToken— UTF-8 stringa, lunga non più di 400000 byte.

  Un token di continuazione, se si tratta di una chiamata di continuazione.

Risposta

• Statements: una matrice di oggetti Dichiarazione.

  Restituisce l'elenco delle istruzioni.

• NextToken— UTF-8 stringa lunga non più di 400000 byte.

  Un token di continuazione, se non sono ancora stati restituiti tutte le istruzioni.

Errori

• AccessDeniedException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• IllegalSessionStateException

Richiesta

• Nessun parametro della richiesta.

Risposta

Risposta contenente i dettagli di configurazione AWS Glue dell'Identity Center.

• ApplicationArn— UTF-8 stringa di lunghezza non inferiore a 10 o superiore a 1224 byte.

  L'Amazon Resource Name (ARN) dell'applicazione Identity Center associata alla configurazione. AWS Glue

• InstanceArn— UTF-8 stringa, lunga non meno di 10 o più di 1224 byte.

  L'Amazon Resource Name (ARN) dell'istanza di Identity Center associata alla configurazione. AWS Glue

• Scopes— Una serie di UTF-8 stringhe.

  Un elenco di ambiti di Identity Center che definiscono le autorizzazioni e i livelli di accesso per la configurazione. AWS Glue

• UserBackgroundSessionsEnabled: booleano.

  Indica se gli utenti possono eseguire sessioni in background quando utilizzano l'autenticazione Identity Center con AWS Glue i servizi.

Errori

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• AccessDeniedException

• ConcurrentModificationException

Richiesta

Richiesta di aggiornamento di una configurazione di AWS Glue Identity Center esistente.

• Scopes— Una serie di UTF-8 stringhe, non meno di 1 o più di 50 stringhe.

  Un elenco di ambiti di Identity Center che definiscono le autorizzazioni e i livelli di accesso aggiornati per la configurazione. AWS Glue

• UserBackgroundSessionsEnabled: booleano.

  Specifica se gli utenti possono eseguire sessioni in background quando utilizzano l'autenticazione Identity Center con i servizi. AWS Glue

Risposta

• Nessun parametro di risposta.

Errori

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• AccessDeniedException

• ConcurrentModificationException

Richiesta

Richiesta di creazione di una nuova configurazione AWS Glue dell'Identity Center.

• InstanceArn— UTF-8 Obbligatoria: stringa lunga non meno di 10 o più di 1224 byte.

  L'Amazon Resource Name (ARN) dell'istanza di Identity Center da associare alla configurazione. AWS Glue

• Scopes— Un array di UTF-8 stringhe, non meno di 1 o più di 50 stringhe.

  Un elenco di ambiti di Identity Center che definiscono le autorizzazioni e i livelli di accesso per la configurazione. AWS Glue

• UserBackgroundSessionsEnabled: booleano.

  Specifica se gli utenti possono eseguire sessioni in background quando utilizzano l'autenticazione Identity Center con i servizi. AWS Glue

Risposta

Risposta derivante dalla creazione di una nuova configurazione di AWS Glue Identity Center.

• ApplicationArn— UTF-8 stringa, lunga non meno di 10 o più di 1224 byte.

  L'Amazon Resource Name (ARN) dell'applicazione Identity Center creata per la configurazione. AWS Glue

Errori

• InvalidInputException

• AlreadyExistsException

• InternalServiceException

• OperationTimeoutException

• AccessDeniedException

• ConcurrentModificationException

Richiesta

• Nessun parametro della richiesta.

Risposta

• Nessun parametro di risposta.

Errori

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• AccessDeniedException

• ConcurrentModificationException