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

L'API Connection Type descrive AWS Glue APIs come descrivere i tipi di connessione.

Gestione della connessione APIs

DescribeConnectionType azione (Python: describe_connection_type)

L'API DescribeConnectionType fornisce tutti i dettagli delle opzioni supportate per un determinato tipo di connessione in AWS Glue.

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

    Il nome del tipo di connessione da descrivere.

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

    Il nome del tipo di connessione.

  • Description: stringa UTF-8, non superiore a 1.024 byte di lunghezza.

    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 UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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 UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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 script ETL di Spark nella mappatura 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 UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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 UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Ogni valore è un oggetto Proprietà.

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

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

    Ogni chiave è una stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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 UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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 UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Ogni valore è un oggetto Proprietà.

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

Errori
  • ValidationException

  • InvalidInputException

  • InternalServiceException

ListConnectionTypes azione (Python: list_connection_types)

L'API ListConnectionTypes fornisce un meccanismo di individuazione in cui apprendere i tipi di connessione disponibili in 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 valore ConnectionType nell'API CreateConnection.

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

    Numero massimo di risultati da restituire.

  • NextToken: stringa UTF-8, non inferiore a 1 o superiore a 2048 byte di lunghezza, 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 oggetti ConnectionTypeBrief contenente brevi informazioni sui tipi di connessione supportati.

  • NextToken: stringa UTF-8, non inferiore a 1 o superiore a 2048 byte di lunghezza, 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 dall'API ListConnectionTypes.

Campi
  • ConnectionType— stringa UTF-8 (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 | ADOBEANALYTICS | SLACK | LINKEDIN | MIXPANEL | ASANA | STRIPE | SMARTSHEET | DATADOG | WOOCOMMERCE INTERCOM SNAPCHATADS| PAYPAL | QUICKBOOKS | FACEBOOKPAGEINSIGHTS FRESHDESK | TWILIO | DOCUSIGNMONITOR | FRESHSALES | ZOOM | GOOGLESEARCHCONSOLE | SALESFORCECOMMERCECLOUD | SAPCONCUR | DYNATRACE MICROSOFTDYNAMIC365FINANCEANDOPS | MICROSOFTTEAMS | BLACKBAUDRAISEREDGENXT | MAILCHIMP | GITLAB | PENDO | PRODUCTBOARD | CIRCLECI | PIPEDIVE SENDGRID | AZURECOSMOS | AZURESQL | BIGQUERY | BLACKBAUD | CLOUDERAHIVE | CLOUDERAIMPALA | CLOUDWATCH | CLOUDWATCHMETRICS CMDB | DATALAKEGEN2 | DB2 | DB2AS400 | DOCUMENTDB | DOMO DYNAMODB GOOGLECLOUDSTORAGE| HBASE | KUSTOMER | MICROSOFTDYNAMICS365CRM | MONDAY | MYSQL | OKTA | OPENSEARCH | ORACLE | PIPEDRIVE | | POSTGRESQL | SAPHANA | SQLSERVER | SYNAPSE | TERADATA | TERADATANOS | TIMESTREAM | TPCDS |VERTICA).

    Il nome del tipo di connessione.

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

    Il nome leggibile dalle persone per il tipo di connessione visualizzato nella console AWS Glue .

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

    Il nome del fornitore o del provider che ha creato o gestisce questo tipo di connessione.

  • Description: stringa UTF-8, non superiore a 1.024 byte di lunghezza.

    Una descrizione del tipo di connessione.

  • Categories – .

    Un elenco di categorie a cui appartiene questo tipo di connessione. Le categorie aiutano gli utenti a filtrare e trovare i tipi di connessione appropriati in base ai loro casi d'uso.

  • Capabilities: un oggetto Funzionalità.

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

  • LogoUrl: stringa UTF-8.

    L'URL del logo associato a un tipo di connessione.

  • ConnectionTypeVariants: una matrice di oggetti ConnectionTypeVariant.

    Un elenco di varianti disponibili per questo tipo di connessione. Varianti diverse possono fornire configurazioni specializzate per casi d'uso specifici o implementazioni dello stesso tipo di connessione generale.

ConnectionTypeVariant struttura

Rappresenta una variante di un tipo di connessione in AWS Glue Data Catalog. Le varianti del tipo di connessione forniscono configurazioni e comportamenti specifici per diverse implementazioni dello stesso tipo di connessione generale.

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

    L'identificatore univoco per la variante del tipo di connessione. Questo nome viene utilizzato internamente per identificare la variante specifica di un tipo di connessione.

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

    Il nome leggibile dall'uomo per la variante del tipo di connessione visualizzata nella console. AWS Glue

  • Description: stringa UTF-8, non superiore a 1.024 byte di lunghezza.

    Una descrizione dettagliata della variante del tipo di connessione, inclusi lo scopo, i casi d'uso e gli eventuali requisiti di configurazione specifici.

  • LogoUrl: stringa UTF-8.

    L'URL del logo associato a una variante del tipo di connessione.

datatypes

Struttura di validazione

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

Campi
  • ValidationType - obbligatorio: stringa UTF-8 (valori validi: REGEX | RANGE).

    Il tipo di convalida da eseguire, ad esempio REGEX.

  • Patterns – .

    Un elenco di modelli che si applicano alla convalida.

  • Description: obbligatorio: stringa UTF-8, non inferiore a 1 o non superiore a 1.024 byte di lunghezza.

    Una descrizione della validazione.

  • MaxLength: numero (intero).

    Lunghezza massima per la proprietà di connessione di una stringa.

  • Maximum: numero (intero).

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

  • Minimum: numero (intero).

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

AuthConfiguration struttura

La configurazione di autenticazione per una connessione restituita dall'API DescribeConnectionType.

Campi
  • AuthenticationType - obbligatorio: un oggetto Proprietà.

    Il tipo di autenticazione da utilizzare per una connessione.

  • SecretArn: un oggetto Proprietà.

    Il nome della risorsa Amazon (ARN) per Secrets Manager.

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

    Ogni chiave è una stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Ogni valore è un oggetto Proprietà.

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

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

    Ogni chiave è una stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Ogni valore è un oggetto Proprietà.

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

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

    Ogni chiave è una stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Ogni valore è un oggetto Proprietà.

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

Struttura delle funzionalità

Specifica i tipi di autenticazione supportati restituiti dall'API DescribeConnectionType.

Campi
  • SupportedAuthenticationTypes - obbligatorio: una matrice di stringhe UTF-8.

    Un elenco di tipi di autenticazione supportati.

  • SupportedDataOperations - obbligatorio: una matrice di stringhe UTF-8.

    Un elenco delle operazioni dei dati supportate.

  • SupportedComputeEnvironments - obbligatorio: una matrice di stringhe UTF-8.

    Un elenco di ambienti di calcolo supportati.

Struttura della proprietà

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

Campi
  • Name: obbligatorio: stringa UTF-8, non inferiore a 1 o non superiore a 128 byte di lunghezza.

    Il nome della proprietà.

  • Description: obbligatorio: stringa UTF-8, non superiore a 1.024 byte di lunghezza.

    Una descrizione della proprietà.

  • Required - obbligatorio: booleano.

    Indica se la proprietà è obbligatoria.

  • PropertyTypes - obbligatorio: una matrice di stringhe UTF-8.

    Descrive il tipo di proprietà.

  • AllowedValues: una matrice di oggetti AllowedValue.

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

  • DataOperationScopes: una matrice di stringhe UTF-8.

    Indica quali operazioni sui dati sono applicabili alla proprietà.

AllowedValue struttura

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

Campi
  • Description: stringa UTF-8, non superiore a 1.024 byte di lunghezza.

    Una descrizione del valore consentito.

  • Value: obbligatorio: stringa UTF-8, non inferiore a 1 o non superiore a 128 byte di lunghezza.

    Il valore consentito per la proprietà.

ComputeEnvironmentConfiguration struttura

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

Campi
  • Name: obbligatorio: stringa UTF-8, non inferiore a 1 o non superiore a 128 byte di lunghezza.

    Un nome per la configurazione dell'ambiente di calcolo.

  • Description: obbligatorio: stringa UTF-8, non superiore a 1.024 byte di lunghezza.

    Una descrizione dell'ambiente di calcolo.

  • ComputeEnvironment - obbligatorio: stringa UTF-8 (valori validi: SPARK | ATHENA | PYTHON).

    Tipo di ambiente di calcolo.

  • SupportedAuthenticationTypes - obbligatorio: una matrice di stringhe UTF-8.

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

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

    Ogni chiave è una stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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 UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Ogni valore è una stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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 UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Ogni valore è una stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

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

  • ConnectionPropertiesRequiredOverridesRichiesto:.

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

  • PhysicalConnectionPropertiesRequired: booleano.

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