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)](#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType) + [ListConnectionTypes azione (Python: list\_connection\_types)](#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes) + [ConnectionTypeBrief struttura](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief) + [ConnectionTypeVariant struttura](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant) ## 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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à](#aws-glue-api-catalog-connections-connections-type-Capabilities). 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à](#aws-glue-api-catalog-connections-connections-type-Property). 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à](#aws-glue-api-catalog-connections-connections-type-Property). Restituisce proprietà che possono essere impostate durante la creazione di una connessione in `ConnectionInput.ConnectionProperties`. `ConnectionOptions`definisce 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](#aws-glue-api-catalog-connections-connections-type-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](#aws-glue-api-catalog-connections-connections-type-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à](#aws-glue-api-catalog-connections-connections-type-Property). 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à](#aws-glue-api-catalog-connections-connections-type-Property). 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à](#aws-glue-api-catalog-connections-connections-type-Property). 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à](#aws-glue-api-catalog-connections-connections-type-Property). 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](aws-glue-api-common.md#regex_11). Un token di continuazione, se si tratta di una chiamata di continuazione. **Risposta** + `ConnectionTypes`: una matrice di oggetti [ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-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](aws-glue-api-common.md#regex_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à](#aws-glue-api-catalog-connections-connections-type-Capabilities). 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](#aws-glue-api-catalog-connections-connections-type-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](#aws-glue-api-catalog-connections-connections-type-Validation) + [AuthConfiguration struttura](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration) + [Struttura delle funzionalità](#aws-glue-api-catalog-connections-connections-type-Capabilities) + [Struttura della proprietà](#aws-glue-api-catalog-connections-connections-type-Property) + [AllowedValue struttura](#aws-glue-api-catalog-connections-connections-type-AllowedValue) + [ComputeEnvironmentConfiguration struttura](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration) ## 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à](#aws-glue-api-catalog-connections-connections-type-Property). Il tipo di autenticazione da utilizzare per una connessione. + `SecretArn`: un oggetto [Proprietà](#aws-glue-api-catalog-connections-connections-type-Property). 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à](#aws-glue-api-catalog-connections-connections-type-Property). 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à](#aws-glue-api-catalog-connections-connections-type-Property). 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à](#aws-glue-api-catalog-connections-connections-type-Property). 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](#aws-glue-api-catalog-connections-connections-type-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à](#aws-glue-api-catalog-connections-connections-type-Property). 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. + `ConnectionPropertiesRequiredOverrides`— *Richiesto:*. Le proprietà di connessione richieste come sostituzioni per l'ambiente di calcolo. + `PhysicalConnectionPropertiesRequired`: booleano. Indica se `PhysicalConnectionProperties` sono necessarie per l'ambiente di calcolo.