Tipi di connessione API - 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à.

Tipi di connessione API

Il tipo di connessione API descrive come AWS Glue APIs descrivere i tipi di connessione.

Gestione delle connessioni APIs

DescribeConnectionType azione (Python: describe_connection_type)

DescribeConnectionTypeAPIFornisce tutti i dettagli delle opzioni supportate per un determinato tipo di connessione in. AWS Glue

Richiesta
  • ConnectionTypeObbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Il nome del tipo di connessione da descrivere.

Risposta
  • ConnectionType— UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Il nome del tipo di connessione.

  • Description— UTF -8 stringhe, di lunghezza non superiore a 1024 byte.

    Una descrizione del tipo di connessione.

  • Capabilities: un oggetto Funzionalità.

    I tipi di autenticazione supportati, i tipi di interfaccia dati (ambienti di calcolo) e le operazioni sui dati del connettore.

  • ConnectionProperties: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto Proprietà.

    Proprietà di connessione comuni in tutti gli ambienti di calcolo.

  • ConnectionOptions: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto Proprietà.

    Restituisce proprietà che possono essere impostate durante la creazione di una connessione in. ConnectionInput.ConnectionProperties ConnectionOptionsdefinisce i parametri che possono essere impostati in uno ETL script Spark nella mappa delle opzioni di connessione passata a un dataframe.

  • AuthenticationConfiguration: un oggetto AuthConfiguration.

    Il tipo di autenticazione utilizzato per la connessione.

  • ComputeEnvironmentConfigurations: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto ComputeEnvironmentConfiguration.

    Gli ambienti di calcolo supportati dalla connessione.

  • PhysicalConnectionRequirements: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto Proprietà.

    Requisiti fisici per una connessione, ad esempio le VPC specifiche della sottorete e del gruppo di sicurezza.

  • AthenaConnectionProperties: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto Proprietà.

    Proprietà di connessione specifiche dell'ambiente di calcolo Athena.

  • PythonConnectionProperties: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto Proprietà.

    Proprietà di connessione specifiche dell'ambiente di calcolo Python.

  • SparkConnectionProperties: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto Proprietà.

    Proprietà di connessione specifiche dell'ambiente di calcolo Spark.

Errori
  • ValidationException

  • InvalidInputException

  • InternalServiceException

ListConnectionTypes azione (Python: list_connection_types)

ListConnectionTypesAPIFornisce un meccanismo di scoperta in cui apprendere i tipi di connessione disponibili. AWS Glue La risposta contiene un elenco di tipi di connessione con dettagli di alto livello su ciò che è supportato per ogni tipo di connessione. I tipi di connessione elencati sono l'insieme di opzioni supportate per il ConnectionType valore in. CreateConnection API

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

    Numero massimo di risultati da restituire.

  • NextToken— UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 2048 byte, corrispondente a. Custom string pattern #11

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

Risposta
  • ConnectionTypes: una matrice di oggetti ConnectionTypeBrief.

    Un elenco di ConnectionTypeBrief oggetti contenente brevi informazioni sui tipi di connessione supportati.

  • NextToken— UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 2048 byte, corrispondente a. Custom string pattern #11

    Un token di continuazione, se il segmento dell'elenco corrente non è l'ultimo.

Errori
  • InternalServiceException

ConnectionTypeBrief struttura

Brevi informazioni su un tipo di connessione supportato restituito da ListConnectionTypesAPI.

Campi
  • ConnectionType— UTF -8 stringhe (valori validi: JDBC SFTP | MONGODB | KAFKA | NETWORK | MARKETPLACE | CUSTOM | SALESFORCE | VIEW_VALIDATION_REDSHIFT | VIEW_VALIDATION_ATHENA | GOOGLEADS | | GOOGLESHEETS | GOOGLEANALYTICS4 | SERVICENOW | MARKETO | SAPODATA | ZENDESK | JIRACLOUD | NETSUITEERP | HUBSPOT | FACEBOOKADS | INSTAGRAMADS | ZOHOCRM | SALESFORCEPARDOT | | SALESFORCEMARKETINGCLOUD | SLACK | STRIPE | INTERCOM |SNAPCHATADS).

    Il nome del tipo di connessione.

  • Description— UTF -8 stringhe, di lunghezza non superiore a 1024 byte.

    Una descrizione del tipo di connessione.

  • Capabilities: un oggetto Funzionalità.

    I tipi di autenticazione supportati, i tipi di interfaccia dati (ambienti di calcolo) e le operazioni sui dati del connettore.

tipi di dati

Struttura di convalida

Definisce come viene eseguita una convalida su una proprietà di connessione.

Campi
  • ValidationTypeObbligatorio: UTF -8 stringhe (valori validi: REGEX |RANGE).

    Il tipo di convalida da eseguire, ad esempioREGEX.

  • Patterns— Un array di UTF -8 stringhe.

    Un elenco di modelli che si applicano alla convalida.

  • DescriptionObbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 1024 byte.

    Una descrizione per la convalida.

  • MaxLength: numero (intero).

    Una lunghezza massima per una proprietà di connessione a stringa.

  • Maximum: numero (intero).

    Un valore massimo quando si specifica un RANGE tipo di convalida.

  • Minimum: numero (intero).

    Un valore minimo quando si specifica un RANGE tipo di convalida.

AuthConfiguration struttura

La configurazione di autenticazione per una connessione restituita da DescribeConnectionTypeAPI.

Campi
  • AuthenticationType: obbligatorio: un oggetto Proprietà.

    Il tipo di autenticazione per una connessione.

  • SecretArn: un oggetto Proprietà.

    L'Amazon Resource Name (ARN) per Secrets Manager.

  • OAuth2Properties: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto Proprietà.

    Una mappa di coppie chiave-valore per le proprietà. OAuth2 Ogni valore è un Property oggetto.

  • BasicAuthenticationProperties: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto Proprietà.

    Una mappa di coppie chiave-valore per le proprietà. OAuth2 Ogni valore è un Property oggetto.

  • CustomAuthenticationProperties: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto Proprietà.

    Una mappa di coppie chiave-valore per le proprietà di autenticazione personalizzate. Ogni valore è un Property oggetto.

Struttura delle funzionalità

Speciifica i tipi di autenticazione supportati restituiti da. DescribeConnectionType API

Campi
  • SupportedAuthenticationTypesObbligatorio: un array di UTF -8 stringhe.

    Un elenco di tipi di autenticazione supportati.

  • SupportedDataOperationsObbligatorio: un array di UTF -8 stringhe.

    Un elenco di operazioni sui dati supportate.

  • SupportedComputeEnvironmentsObbligatorio: un array di UTF -8 stringhe.

    Un elenco di ambienti di elaborazione supportati.

Struttura della proprietà

Un oggetto che definisce un tipo di connessione per un ambiente di calcolo.

Campi
  • NameObbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il nome della proprietà.

  • DescriptionRichiesto: UTF -8 stringhe, di lunghezza non superiore a 1024 byte.

    Una descrizione della proprietà.

  • DataTypeObbligatorio: UTF -8 stringhe (valori validi: STRING INTEGER | BOOLEAN | |STRING_LIST).

    Il tipo di dati della proprietà.

  • Required: obbligatorio: booleano.

    Indica se la proprietà è obbligatoria.

  • DefaultValue— UTF -8 stringhe.

    Il valore predefinito per la proprietà.

  • PropertyTypesObbligatorio: un array di UTF -8 stringhe.

    Descrive il tipo di proprietà.

  • AllowedValues: una matrice di oggetti AllowedValue.

    Un elenco di AllowedValue oggetti che rappresentano i valori consentiti per la proprietà.

  • DataOperationScopes— Un array di UTF -8 stringhe.

    Indica quali operazioni sui dati sono applicabili alla proprietà.

AllowedValue struttura

Un oggetto che rappresenta un valore consentito per una proprietà.

Campi
  • Description— UTF -8 stringhe, di lunghezza non superiore a 1024 byte.

    Una descrizione del valore consentito.

  • ValueObbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il valore consentito per la proprietà.

ComputeEnvironmentConfiguration struttura

Un oggetto contenente la configurazione per un ambiente di calcolo (come Spark, Python o Athena) restituito da. DescribeConnectionType API

Campi
  • NameObbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 128 byte.

    Un nome per la configurazione dell'ambiente di calcolo.

  • DescriptionRichiesto: UTF -8 stringhe, di lunghezza non superiore a 1024 byte.

    Una descrizione dell'ambiente di calcolo.

  • ComputeEnvironmentObbligatorio: UTF -8 stringhe (valori validi: SPARK | ATHENA |PYTHON).

    Tipo di ambiente di calcolo.

  • SupportedAuthenticationTypesObbligatorio: un array di UTF -8 stringhe.

    I tipi di autenticazione supportati per l'ambiente di calcolo.

  • ConnectionOptions: obbligatorio: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è un oggetto Proprietà.

    I parametri utilizzati come opzioni di connessione per l'ambiente di calcolo.

  • ConnectionPropertyNameOverrides: obbligatorio: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è una stringa di UTF -8, lunga almeno 1 o più di 128 byte.

    Il nome della proprietà di connessione ha la precedenza per l'ambiente di calcolo.

  • ConnectionOptionNameOverrides: obbligatorio: una matrice della mappa di coppie chiave-valore.

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

    Ogni valore è una stringa di UTF -8, lunga almeno 1 o più di 128 byte.

    Il nome dell'opzione di connessione ha la precedenza per l'ambiente di calcolo.

  • ConnectionPropertiesRequiredOverridesObbligatorio: un array di -8 stringhe. UTF

    Le proprietà di connessione richieste come sostituzioni per l'ambiente di calcolo.

  • PhysicalConnectionPropertiesRequired: booleano.

    Indica se PhysicalConnectionProperties sono necessarie per l'ambiente di calcolo.