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 Connessioni
L'API Connections descrive i tipi di dati e l'API relativi all'utilizzo delle connessioni in AWS Glue.
**Topics**
+ [API di connessione](aws-glue-api-catalog-connections-connections.md)
+ [API Tipi di connessione](aws-glue-api-catalog-connections-connections-type.md)
+ [Metadati di connessione e API di anteprima](aws-glue-api-catalog-connections-connections-metadata.md)
# API di connessione
L'API Connection descrive i tipi di dati di AWS Glue connessione e l'API per creare, eliminare, aggiornare ed elencare le connessioni.
## Tipi di dati
+ [Struttura di connessione](#aws-glue-api-catalog-connections-connections-Connection)
+ [ConnectionInput struttura](#aws-glue-api-catalog-connections-connections-ConnectionInput)
+ [TestConnectionInput struttura](#aws-glue-api-catalog-connections-connections-TestConnectionInput)
+ [PhysicalConnectionRequirements struttura](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements)
+ [GetConnectionsFilter struttura](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter)
+ [AuthenticationConfiguration struttura](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration)
+ [AuthenticationConfigurationInput struttura](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput)
+ [OAuth2Struttura delle proprietà](#aws-glue-api-catalog-connections-connections-OAuth2Properties)
+ [OAuth2PropertiesInput struttura](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput)
+ [OAuth2ClientApplication struttura](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication)
+ [AuthorizationCodeProperties struttura](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties)
+ [BasicAuthenticationCredentials struttura](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials)
+ [OAuth2struttura delle credenziali](#aws-glue-api-catalog-connections-connections-OAuth2Credentials)
## Struttura di connessione
Definisce una connessione a un'origine dati.
**Campi**
+ `Name`: 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 della definizione di connessione.
+ `Description`: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
La descrizione della connessione.
+ `ConnectionType`— Stringa UTF-8 (valori validi: `JDBC` `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` `DYNAMODB` `GOOGLECLOUDSTORAGE`\$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Il tipo di connessione. Attualmente, SFTP non è supportato.
+ `MatchCriteria`: una matrice di stringhe UTF-8, non superiore a 10 stringhe.
Un elenco di criteri che possono essere utilizzati nella selezione di questa connessione.
+ `ConnectionProperties`: una matrice di mappe con coppie chiave-valore, non superiore alle 100 coppie.
Ogni chiave è una stringa UTF-8 (valori validi: `HOST` \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` `KAFKA_SASL_GSSAPI_KEYTAB` `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` `WORKGROUP_NAME` `CLUSTER_IDENTIFIER` \$1`DATABASE`).
Ogni valore è una stringa Value, non inferiore a 1 o superiore a 1.024 byte di lunghezza.
Queste coppie chiave-valore definiscono i parametri per la connessione quando si utilizza lo schema di connessione versione 1:
+ `HOST`- L'URI dell'host: il nome di dominio completo (FQDN) o l' IPv4 indirizzo dell'host del database.
+ `PORT`: il numero della porta, compreso tra 1024 e 65535, della porta su cui l'host del database ascolta le connessioni del database.
+ `USER_NAME`: il nome sotto il quale accedere al database. La stringa del valore per `USER_NAME` è `USERNAME`.
+ `PASSWORD`: una password, se usata, per il nome utente.
+ `ENCRYPTED_PASSWORD`: quando si abilita la protezione della password di connessione impostando `ConnectionPasswordEncryption` nelle impostazioni di crittografia del catalogo dati, questo campo memorizza la password crittografata.
+ `JDBC_DRIVER_JAR_URI`: il percorso Amazon Simple Storage Service (Amazon S3) del file JAR che contiene il driver JDBC da utilizzare.
+ `JDBC_DRIVER_CLASS_NAME`: il nome classe del driver JDBC da utilizzare.
+ `JDBC_ENGINE`: il nome del motore JDBC da utilizzare.
+ `JDBC_ENGINE_VERSION`: la versione del motore JDBC da utilizzare.
+ `CONFIG_FILES`: (Riservato per uso futuro).
+ `INSTANCE_ID`: l'ID istanza da utilizzare.
+ `JDBC_CONNECTION_URL`: l'URL per la connessione a un'origine dati JDBC.
+ `JDBC_ENFORCE_SSL`: una stringa booleana (true, false) che fa distinzione tra maiuscole e minuscole che specifica se il protocollo Secure Sockets Layer (SSL) con nome host corrispondente viene applicato per la connessione JDBC al client. Il valore predefinito è false.
+ `CUSTOM_JDBC_CERT`- Una posizione Amazon S3 che specifica il certificato principale del cliente. AWS Glue utilizza questo certificato radice per convalidare il certificato del cliente durante la connessione al database dei clienti. AWS Glue gestisce solo certificati X.509. Il certificato fornito deve essere codificato DER e fornito in formato PEM con codifica Base64.
+ `SKIP_CUSTOM_JDBC_CERT_VALIDATION`- Per impostazione predefinita, questo è. `false` AWS Glue convalida l'algoritmo Signature e Subject Public Key Algorithm per il certificato del cliente. Gli unici algoritmi consentiti per l'algoritmo Signature sono SHA256with RSA, RSA o SHA384with RSA. SHA512with Per l'algoritmo della chiave pubblica oggetto, la lunghezza della chiave deve essere almeno 2048. Puoi impostare il valore di questa proprietà su `true` per ignorare la convalida di AWS Glue del certificato del cliente.
+ `CUSTOM_JDBC_CERT_STRING`- Una stringa di certificato JDBC personalizzata che viene utilizzata per la corrispondenza tra domini o nomi distinti per prevenire un attacco. man-in-the-middle Nel database Oracle, viene utilizzato come `SSL_SERVER_CERT_DN`; in Microsoft SQL Server, viene utilizzato come `hostNameInCertificate`.
+ `CONNECTION_URL`: l'URL per la connessione a un'origine dati generale (non JDBC).
+ `SECRET_ID`: l'ID segreto utilizzato per il Secret Manager delle credenziali.
+ `CONNECTOR_URL`: l'URL del connettore per una connessione MARKETPLACE o CUSTOM.
+ `CONNECTOR_TYPE`: il tipo di connettore per una connessione MARKETPLACE o CUSTOM.
+ `CONNECTOR_CLASS_NAME`: il nome di classe del connettore per una connessione MARKETPLACE o CUSTOM.
+ `KAFKA_BOOTSTRAP_SERVERS`: un elenco separato da virgole di coppie host e porte che sono gli indirizzi dei broker Apache Kafka in un cluster Kafka a cui un client Kafka si connetterà e si avvierà.
+ `KAFKA_SSL_ENABLED`: indica se abilitare o disabilitare SSL su una connessione Apache Kafka. Il valore di default è "true".
+ `KAFKA_CUSTOM_CERT`: l'URL Amazon S3 per il file di certificazione CA privato (formato .pem). L'impostazione predefinita è una stringa vuota.
+ `KAFKA_SKIP_CUSTOM_CERT_VALIDATION`- Se saltare o meno la convalida del file di certificato CA. AWS Glue esegue la convalida per tre algoritmi: SHA256with RSA, RSA e RSA. SHA384with SHA512with Il valore predefinito è "false".
+ `KAFKA_CLIENT_KEYSTORE`: la posizione Amazon S3 del file keystore del client per l'autenticazione lato client Kafka (facoltativo).
+ `KAFKA_CLIENT_KEYSTORE_PASSWORD`: la password per accedere al keystore fornito (facoltativo).
+ `KAFKA_CLIENT_KEY_PASSWORD`: un keystore può essere costituito da più chiavi, quindi questa è la password per accedere alla chiave client da utilizzare con la chiave lato server Kafka (facoltativo).
+ `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD`- La versione crittografata della password del keystore del client Kafka (se l'utente ha selezionato l'impostazione di crittografia delle password). AWS Glue
+ `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD`- La versione crittografata della password della chiave del client Kafka (se l'utente ha selezionato l'impostazione di crittografia delle password). AWS Glue
+ `KAFKA_SASL_MECHANISM`: `"SCRAM-SHA-512"`, `"GSSAPI"`, `"AWS_MSK_IAM"` o `"PLAIN"`. Queste sono i due [meccanismi SASL](https://www.iana.org/assignments/sasl-mechanisms/sasl-mechanisms.xhtml) supportati.
+ `KAFKA_SASL_PLAIN_USERNAME`: un nome utente in testo normale utilizzato per l'autenticazione con il meccanismo “PLAIN”.
+ `KAFKA_SASL_PLAIN_PASSWORD`: una password in testo normale utilizzata per l'autenticazione con il meccanismo “PLAIN”.
+ `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD`- La versione crittografata della password Kafka SASL PLAIN (se l'utente ha selezionato l'impostazione di crittografia delle password). AWS Glue
+ `KAFKA_SASL_SCRAM_USERNAME`: un nome utente in testo semplice utilizzato per autenticarsi con il meccanismo "SCRAM-SHA-512".
+ `KAFKA_SASL_SCRAM_PASSWORD`: una password in testo semplice utilizzata per autenticarsi con il meccanismo "SCRAM-SHA-512".
+ `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD`- La versione crittografata della password Kafka SASL SCRAM (se l'utente ha selezionato l'impostazione di crittografia delle password). AWS Glue
+ `KAFKA_SASL_SCRAM_SECRETS_ARN`- Il nome di risorsa Amazon di un segreto in AWS Secrets Manager.
+ `KAFKA_SASL_GSSAPI_KEYTAB`: la posizione S3 di un file `keytab` Kerberos. Un keytab memorizza le chiavi a lungo termine per uno o più principali. Per ulteriori informazioni, consulta la [Documentazione di MIT Kerberos: keytab](https://web.mit.edu/kerberos/krb5-latest/doc/basic/keytab_def.html).
+ `KAFKA_SASL_GSSAPI_KRB5_CONF`: la posizione S3 di un file `krb5.conf` Kerberos. Un krb5.conf memorizza le informazioni di configurazione Kerberos, ad esempio la posizione del server KDC. Per ulteriori informazioni, consulta la [Documentazione di MIT Kerberos: krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html).
+ `KAFKA_SASL_GSSAPI_SERVICE`: il nome del servizio Kerberos, come impostato con `sasl.kerberos.service.name` nella [Configurazione Kafka](https://kafka.apache.org/documentation/#brokerconfigs_sasl.kerberos.service.name).
+ `KAFKA_SASL_GSSAPI_PRINCIPAL`- Il nome del principale Kerberos utilizzato da. AWS Glue Per ulteriori informazioni, consulta la [Documentazione di Kafka: configurazione dei broker Kafka](https://kafka.apache.org/documentation/#security_sasl_kerberos_clientconfig).
+ `ROLE_ARN`: il ruolo da utilizzare per l'esecuzione delle query.
+ `REGION`- La AWS regione in cui verranno eseguite le interrogazioni.
+ `WORKGROUP_NAME`: il nome di un gruppo di lavoro Amazon Redshift serverless o Amazon Athena in cui verranno eseguite le query.
+ `CLUSTER_IDENTIFIER`: l'identificatore del cluster Amazon Redshift in cui verranno eseguite le query.
+ `DATABASE`: il database Amazon Redshift a cui stai effettuando la connessione.
+ `SparkProperties`: 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 chiave è una stringa UTF-8, non inferiore a 1 o superiore a 2.048 byte di lunghezza.
Proprietà di connessione specifiche dell'ambiente di calcolo Spark.
+ `AthenaProperties`: 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 chiave è una stringa UTF-8, non inferiore a 1 o superiore a 2.048 byte di lunghezza.
Proprietà di connessione specifiche dell'ambiente di calcolo Athena.
+ `PythonProperties`: 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 chiave è una stringa UTF-8, non inferiore a 1 o superiore a 2.048 byte di lunghezza.
Proprietà di connessione specifiche dell'ambiente di calcolo Python.
+ `PhysicalConnectionRequirements`: un oggetto [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements).
I requisiti di connessione fisici, come un cloud privato virtuale (VPC) e un `SecurityGroup`, necessari per effettuare questa connessione.
+ `CreationTime`: timestamp.
Il timestamp dell'ora in cui è stata creata questa definizione della connessione.
+ `LastUpdatedTime`: timestamp.
Il timestamp dell'ultima volta in cui è stata aggiornata la definizione della connessione.
+ `LastUpdatedBy`: 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).
L'utente, gruppo o ruolo che ha aggiornato per ultimo questa definizione di connessione.
+ `Status`: stringa UTF-8 (valori validi: `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).
Lo stato della connessione. Può essere `READY`, `IN_PROGRESS` o `FAILED`.
+ `StatusReason`: stringa UTF-8, non inferiore a 1 o superiore a 16.384 byte di lunghezza.
Il motivo dello stato della connessione.
+ `LastConnectionValidationTime`: timestamp.
Un timestamp dell'ora in cui questa connessione è stata convalidata l'ultima volta.
+ `AuthenticationConfiguration`: un oggetto [AuthenticationConfiguration](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration).
Le proprietà di autenticazione della connessione.
+ `ConnectionSchemaVersion`: numero (intero), non inferiore a 1 o superiore a 2.
La versione dello schema di connessione per questa connessione. La versione 2 supporta proprietà per ambienti di calcolo specifici.
+ `CompatibleComputeEnvironments`: una matrice di stringhe UTF-8.
Un elenco di ambienti di calcolo compatibili con la connessione.
## ConnectionInput struttura
Una struttura utilizzata per specificare una connessione da creare o aggiornare.
**Campi**
+ `Name` - *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 della connessione.
+ `Description`: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
La descrizione della connessione.
+ `ConnectionType`— *Obbligatoria:* stringa UTF-8 (valori validi: `JDBC` `SFTP` `MONGODB` \$1 `KAFKA` \$1 \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` `DATADOG` `WOOCOMMERCE`\$1 `INTERCOM` `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` `DOCUMENTDB` `DOMO`\$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Il tipo di connessione. Attualmente, sono supportati questi tipi:
+ `JDBC`: designa una connessione a un database tramite Java Database Connectivity (JDBC).
`JDBC`Le connessioni utilizzano quanto segue ConnectionParameters.
+ Obbligatorio: tutti (`HOST`, `PORT`, `JDBC_ENGINE`) o `JDBC_CONNECTION_URL`.
+ Obbligatorio: tutti (`USERNAME`, `PASSWORD`) o `SECRET_ID`.
+ Facoltativo: `JDBC_ENFORCE_SSL`, `CUSTOM_JDBC_CERT`, `CUSTOM_JDBC_CERT_STRING`, `SKIP_CUSTOM_JDBC_CERT_VALIDATION`. Questi parametri vengono utilizzati per configurare SSL con JDBC.
+ `KAFKA`: indica una connessione a una piattaforma di streaming Apache Kafka.
`KAFKA`Le connessioni utilizzano quanto segue ConnectionParameters.
+ Obbligatorio: `KAFKA_BOOTSTRAP_SERVERS`.
+ Facoltativo: `KAFKA_SSL_ENABLED`, `KAFKA_CUSTOM_CERT`, `KAFKA_SKIP_CUSTOM_CERT_VALIDATION`. Questi parametri vengono utilizzati per configurare SSL con `KAFKA`.
+ Facoltativo: `KAFKA_CLIENT_KEYSTORE`, `KAFKA_CLIENT_KEYSTORE_PASSWORD`, `KAFKA_CLIENT_KEY_PASSWORD`, `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD`, `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD`. Questi parametri vengono utilizzati per impostare la configurazione del client TLS con SSL in `KAFKA`.
+ Facoltativo: `KAFKA_SASL_MECHANISM`. Può essere specificato come `SCRAM-SHA-512`, `GSSAPI` o `AWS_MSK_IAM`.
+ Facoltativo: `KAFKA_SASL_SCRAM_USERNAME`, `KAFKA_SASL_SCRAM_PASSWORD`, `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD`. Questi parametri vengono utilizzati per configurare l'autenticazione SASL/SCRAM-SHA-512 con `KAFKA`.
+ Facoltativo: `KAFKA_SASL_GSSAPI_KEYTAB`, `KAFKA_SASL_GSSAPI_KRB5_CONF`, `KAFKA_SASL_GSSAPI_SERVICE`, `KAFKA_SASL_GSSAPI_PRINCIPAL`. Questi parametri vengono utilizzati per configurare SASL/GSSAPI l'autenticazione con`KAFKA`.
+ `MONGODB`: designa una connessione a un database di documenti MongoDB.
`MONGODB`Le connessioni utilizzano quanto segue ConnectionParameters.
+ Obbligatorio: `CONNECTION_URL`.
+ Obbligatorio: tutti (`USERNAME`, `PASSWORD`) o `SECRET_ID`.
+ `VIEW_VALIDATION_REDSHIFT`: indica una connessione utilizzata per la convalida della visualizzazione da parte di Amazon Redshift.
+ `VIEW_VALIDATION_ATHENA`: indica una connessione utilizzata per la convalida della visualizzazione da parte di Amazon Athena.
+ `NETWORK`: designa una connessione di rete a un'origine dati all'interno di un ambiente Amazon Virtual Private Cloud (Amazon VPC).
`NETWORK`Le connessioni non richiedono ConnectionParameters. Fornisci invece un PhysicalConnectionRequirements.
+ `MARKETPLACE`- Utilizza le impostazioni di configurazione contenute in un connettore acquistato Marketplace AWS per leggere e scrivere su archivi dati che non sono supportati nativamente da AWS Glue.
`MARKETPLACE`Le connessioni utilizzano quanto segue ConnectionParameters.
+ Obbligatorio: `CONNECTOR_TYPE`, `CONNECTOR_URL`, `CONNECTOR_CLASS_NAME`, `CONNECTION_URL`.
+ Obbligatorio per le connessioni `JDBC` `CONNECTOR_TYPE`: tutti (`USERNAME`, `PASSWORD`) o `SECRET_ID`.
+ `CUSTOM`: utilizza le impostazioni di configurazione contenute in un connettore per leggere e scrivere in archivi dati non supportati nativamente da AWS Glue.
Per ulteriori informazioni sui parametri di connessione necessari per un particolare connettore, consultate la documentazione relativa al connettore in [Aggiungere una AWS Glue connessione](https://docs.aws.amazon.com/glue/latest/dg/console-connections.html) nella Guida per l' AWS Glue utente.
`SFTP` non è supportato.
Per ulteriori informazioni sull'utilizzo delle funzionalità ConnectionProperties opzionali in AWS Glue, consulta le [proprietà di AWS Glue connessione](https://docs.aws.amazon.com/glue/latest/dg/connection-defining.html).
Per ulteriori informazioni su come ConnectionProperties vengono utilizzate le funzionalità opzionali per configurare le funzionalità in AWS Glue Studio, consulta [Utilizzo di connettori e connessioni](https://docs.aws.amazon.com/glue/latest/ug/connectors-chapter.html).
+ `MatchCriteria`: una matrice di stringhe UTF-8, non superiore a 10 stringhe.
Un elenco di criteri che possono essere utilizzati nella selezione di questa connessione.
+ `ConnectionProperties`: *obbligatorio:* una matrice di mappe di coppie chiave-valore, non superiore a 100 coppie.
Ogni chiave è una stringa UTF-8 (valori validi: `HOST` \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` `KAFKA_SASL_GSSAPI_KEYTAB` `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` `WORKGROUP_NAME` `CLUSTER_IDENTIFIER` \$1`DATABASE`).
Ogni valore è una stringa Value, non inferiore a 1 o superiore a 1.024 byte di lunghezza.
Queste coppie chiave-valore definiscono i parametri per la connessione.
+ `SparkProperties`: 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 chiave è una stringa UTF-8, non inferiore a 1 o superiore a 2.048 byte di lunghezza.
Proprietà di connessione specifiche dell'ambiente di calcolo Spark.
+ `AthenaProperties`: 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 chiave è una stringa UTF-8, non inferiore a 1 o superiore a 2.048 byte di lunghezza.
Proprietà di connessione specifiche dell'ambiente di calcolo Athena.
+ `PythonProperties`: 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 chiave è una stringa UTF-8, non inferiore a 1 o superiore a 2.048 byte di lunghezza.
Proprietà di connessione specifiche dell'ambiente di calcolo Python.
+ `PhysicalConnectionRequirements`: un oggetto [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements).
I requisiti di connessione fisici, come un cloud privato virtuale (VPC) e un `SecurityGroup`, necessari per effettuare correttamente questa connessione.
+ `AuthenticationConfiguration`: un oggetto [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput).
Le proprietà di autenticazione della connessione.
+ `ValidateCredentials`: booleano.
Una spunta per convalidare le credenziali durante la creazione della connessione. Il valore predefinito è true.
+ `ValidateForComputeEnvironments`: una matrice di stringhe UTF-8.
Gli ambienti di calcolo in cui vengono convalidate le proprietà di connessione specificate.
## TestConnectionInput struttura
Una struttura utilizzata per specificare il test di una connessione a un servizio.
**Campi**
+ `ConnectionType`— *Obbligatoria:* stringa UTF-8 (valori validi: `JDBC` `SFTP` `MONGODB` \$1 `KAFKA` \$1 \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` `DATADOG` `WOOCOMMERCE`\$1 `INTERCOM` `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` `DOCUMENTDB` `DOMO`\$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Il tipo di connessione da testare. Questa operazione è disponibile solo per i tipi di connessione `JDBC` o `SALESFORCE`.
+ `ConnectionProperties`: *obbligatorio:* una matrice di mappe di coppie chiave-valore, non superiore a 100 coppie.
Ogni chiave è una stringa UTF-8 (valori validi: `HOST` \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` `KAFKA_SASL_GSSAPI_KEYTAB` `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` `WORKGROUP_NAME` `CLUSTER_IDENTIFIER` \$1`DATABASE`).
Ogni valore è una stringa Value, non inferiore a 1 o superiore a 1.024 byte di lunghezza.
Le coppie chiave-valore che definiscono i parametri per la connessione.
Le connessioni JDBC utilizzano le seguenti proprietà di connessione:
+ Obbligatorio: tutti (`HOST`, `PORT`, `JDBC_ENGINE`) o `JDBC_CONNECTION_URL`.
+ Obbligatorio: tutti (`USERNAME`, `PASSWORD`) o `SECRET_ID`.
+ Facoltativo: `JDBC_ENFORCE_SSL`, `CUSTOM_JDBC_CERT`, `CUSTOM_JDBC_CERT_STRING`, `SKIP_CUSTOM_JDBC_CERT_VALIDATION`. Questi parametri vengono utilizzati per configurare SSL con JDBC.
Le connessioni SALESFORCE richiedono la configurazione del membro `AuthenticationConfiguration`.
+ `AuthenticationConfiguration`: un oggetto [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput).
Una struttura contenente la configurazione di autenticazione nella TestConnection richiesta. Richiesto per una connessione a Salesforce tramite OAuth autenticazione.
## PhysicalConnectionRequirements struttura
L'app OAuth client in GetConnection risposta.
**Campi**
+ `SubnetId`: 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).
L'ID della sottorete utilizzato dalla connessione.
+ `SecurityGroupIdList`: una matrice di stringhe UTF-8, non superiore a 50 stringhe.
L'elenco di ID del gruppo di sicurezza utilizzato dalla connessione.
+ `AvailabilityZone`: 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).
La zona di disponibilità della connessione.
## GetConnectionsFilter struttura
Filtra le definizioni di connessione restituite dall'operazione API `GetConnections`.
**Campi**
+ `MatchCriteria`: una matrice di stringhe UTF-8, non superiore a 10 stringhe.
Una stringa di criteri che deve corrispondere ai criteri registrati nella definizione di connessione affinché venga restituita quella definizione di connessione.
+ `ConnectionType`— stringa UTF-8 (valori validi: `JDBC` \$1 \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` `DYNAMODB` `GOOGLECLOUDSTORAGE`\$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Il tipo di connessioni da restituire. Attualmente, SFTP non è supportato.
+ `ConnectionSchemaVersion`: numero (intero), non inferiore a 1 o superiore a 2.
Indica se la connessione è stata creata con la versione 1 o 2 dello schema.
## AuthenticationConfiguration struttura
Una struttura contenente la configurazione dell'autenticazione.
**Campi**
+ `AuthenticationType`: stringa UTF-8 (valori validi: `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).
Una struttura contenente la configurazione dell'autenticazione.
+ `SecretArn`: stringa UTF-8, corrispondente a [Custom string pattern #36](aws-glue-api-common.md#regex_36).
L'ARN del gestore segreto per archiviare le credenziali.
+ `KmsKeyArn`: stringa UTF-8, corrispondente a [Custom string pattern #42](aws-glue-api-common.md#regex_42).
Il nome della risorsa Amazon (ARN) della chiave KMS utilizzato per crittografare le informazioni di autenticazione sensibili. Questa chiave viene utilizzata per proteggere le credenziali e altri dati sensibili archiviati nella configurazione di autenticazione.
+ `OAuth2Properties`: un oggetto [OAuth2Proprietà](#aws-glue-api-catalog-connections-connections-OAuth2Properties).
Le proprietà per OAuth2 l'autenticazione.
## AuthenticationConfigurationInput struttura
Una struttura contenente la configurazione di autenticazione nella CreateConnection richiesta.
**Campi**
+ `AuthenticationType`: stringa UTF-8 (valori validi: `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).
Una struttura contenente la configurazione di autenticazione nella CreateConnection richiesta.
+ `OAuth2Properties`: un oggetto [OAuth2PropertiesInput](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput).
Le proprietà per OAuth2 l'autenticazione nella CreateConnection richiesta.
+ `SecretArn`: stringa UTF-8, corrispondente a [Custom string pattern #36](aws-glue-api-common.md#regex_36).
L'ARN del gestore segreto per memorizzare le credenziali nella richiesta. CreateConnection
+ `KmsKeyArn`: stringa UTF-8, corrispondente a [Custom string pattern #42](aws-glue-api-common.md#regex_42).
L'ARN della chiave KMS da utilizzare per crittografare la connessione. Viene preso solo come input nella richiesta e archiviato in Secrets Manager.
+ `BasicAuthenticationCredentials`: un oggetto [BasicAuthenticationCredentials](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials).
Le credenziali utilizzate quando il tipo di autenticazione è di base.
+ `CustomAuthenticationCredentials`: 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 chiave è una stringa UTF-8, non inferiore a 1 o superiore a 2.048 byte di lunghezza.
Le credenziali utilizzate quando il tipo di autenticazione è personalizzato.
## OAuth2Struttura delle proprietà
Una struttura contenente proprietà per OAuth2 l'autenticazione.
**Campi**
+ `OAuth2GrantType`: stringa UTF-8 (valori validi: `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).
Il tipo di OAuth2 concessione. Ad esempio, `AUTHORIZATION_CODE`, `JWT_BEARER` o `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication`: un oggetto [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication).
Il tipo di applicazione client. Ad esempio, AWS\$1MANAGED o USER\$1MANAGED.
+ `TokenUrl`: stringa UTF-8, non superiore a 256 byte di lunghezza, corrispondente a [Custom string pattern #40](aws-glue-api-common.md#regex_40).
L'URL del server di autenticazione del provider, per scambiare un codice di autorizzazione per un token di accesso.
+ `TokenUrlParametersMap`: 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 512 byte di lunghezza.
Una mappa dei parametri che vengono aggiunti alla richiesta del token `GET`.
## OAuth2PropertiesInput struttura
Una struttura contenente le proprietà per OAuth2 la CreateConnection richiesta.
**Campi**
+ `OAuth2GrantType`: stringa UTF-8 (valori validi: `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).
Il tipo di OAuth2 concessione nella CreateConnection richiesta. Ad esempio, `AUTHORIZATION_CODE`, `JWT_BEARER` o `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication`: un oggetto [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication).
Il tipo di applicazione client nella CreateConnection richiesta. Ad esempio `AWS_MANAGED` o `USER_MANAGED`.
+ `TokenUrl`: stringa UTF-8, non superiore a 256 byte di lunghezza, corrispondente a [Custom string pattern #40](aws-glue-api-common.md#regex_40).
L'URL del server di autenticazione del provider, per scambiare un codice di autorizzazione per un token di accesso.
+ `TokenUrlParametersMap`: 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 512 byte di lunghezza.
Una mappa dei parametri che vengono aggiunti alla richiesta del token `GET`.
+ `AuthorizationCodeProperties`: un oggetto [AuthorizationCodeProperties](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties).
L'insieme di proprietà richieste per il tipo di OAuth2 `AUTHORIZATION_CODE` concessione.
+ `OAuth2Credentials`: un oggetto [OAuth2Credenziali](#aws-glue-api-catalog-connections-connections-OAuth2Credentials).
Le credenziali utilizzate quando il tipo di autenticazione è OAuth2 l'autenticazione.
## OAuth2ClientApplication struttura
L'app OAuth2 client utilizzata per la connessione.
**Campi**
+ `UserManagedClientApplicationClientId`: stringa UTF-8, non superiore a 2048 byte di lunghezza, corrispondente a [Custom string pattern #37](aws-glue-api-common.md#regex_37).
L'applicazione client ClientID, se lo è ClientAppType . `USER_MANAGED`
+ `AWSManagedClientApplicationReference`: stringa UTF-8, non superiore a 2048 byte di lunghezza, corrispondente a [Custom string pattern #37](aws-glue-api-common.md#regex_37).
Il riferimento all'app client lato SaaS gestita. AWS
## AuthorizationCodeProperties struttura
L'insieme di proprietà richieste per il flusso di lavoro relativo al tipo di OAuth2 `AUTHORIZATION_CODE` sovvenzione.
**Campi**
+ `AuthorizationCode`: stringa UTF-8, non inferiore a 1 o superiore a 4.096 byte di lunghezza, corrispondente a [Custom string pattern #37](aws-glue-api-common.md#regex_37).
Un codice di autorizzazione da utilizzare nella terza fase del flusso di lavoro di concessione `AUTHORIZATION_CODE`. Si tratta di un codice monouso che diventa non valido una volta scambiato con un token di accesso, quindi è accettabile avere tale valore come parametro di richiesta.
+ `RedirectUri`: stringa UTF-8, non superiore a 512 byte di lunghezza, corrispondente a [Custom string pattern #41](aws-glue-api-common.md#regex_41).
L'URI di reindirizzamento a cui l'utente viene reindirizzato dal server di autorizzazione quando emette un codice di autorizzazione. L'URI viene successivamente utilizzato quando il codice di autorizzazione viene scambiato per un token di accesso.
## BasicAuthenticationCredentials struttura
Per assegnare credenziali di autenticazione di base quando non si fornisce un valore `SecretArn`.
**Campi**
+ `Username`: stringa UTF-8, non superiore a 512 byte di lunghezza, corrispondente a [Custom string pattern #37](aws-glue-api-common.md#regex_37).
Il nome utente da connettere all'origine dati.
+ `Password`: stringa UTF-8, non superiore a 512 byte di lunghezza, corrispondente a [Custom string pattern #33](aws-glue-api-common.md#regex_33).
La password per la connessione all'origine dati.
## OAuth2struttura delle credenziali
Le credenziali utilizzate quando il tipo di autenticazione è OAuth2 l'autenticazione.
**Campi**
+ `UserManagedClientApplicationClientSecret`: stringa UTF-8, non superiore a 512 byte di lunghezza, corrispondente a [Custom string pattern #38](aws-glue-api-common.md#regex_38).
Il segreto del client dell'applicazione client se è gestita dall'utente.
+ `AccessToken`: stringa UTF-8, non superiore a 4.096 byte di lunghezza, corrispondente a [Custom string pattern #38](aws-glue-api-common.md#regex_38).
Il token di accesso utilizzato quando il tipo di autenticazione è OAuth2.
+ `RefreshToken`: stringa UTF-8, non superiore a 4.096 byte di lunghezza, corrispondente a [Custom string pattern #38](aws-glue-api-common.md#regex_38).
Il token di aggiornamento utilizzato quando il tipo di autenticazione è OAuth2.
+ `JwtToken`: stringa UTF-8, non superiore a 8.000 byte di lunghezza, corrispondente a [Custom string pattern #39](aws-glue-api-common.md#regex_39).
Il JSON Web Token (JWT) utilizzato quando il tipo di autenticazione è. OAuth2
## Operazioni
+ [CreateConnection azione (Python: create\$1connection)](#aws-glue-api-catalog-connections-connections-CreateConnection)
+ [DeleteConnection azione (Python: delete\$1connection)](#aws-glue-api-catalog-connections-connections-DeleteConnection)
+ [GetConnection azione (Python: get\$1connection)](#aws-glue-api-catalog-connections-connections-GetConnection)
+ [GetConnections azione (Python: get\$1connections)](#aws-glue-api-catalog-connections-connections-GetConnections)
+ [UpdateConnection azione (Python: update\$1connection)](#aws-glue-api-catalog-connections-connections-UpdateConnection)
+ [TestConnection azione (Python: test\$1connection)](#aws-glue-api-catalog-connections-connections-TestConnection)
+ [BatchDeleteConnection azione (Python: batch\$1delete\$1connection)](#aws-glue-api-catalog-connections-connections-BatchDeleteConnection)
## CreateConnection azione (Python: create\$1connection)
Crea una definizione di connessione nel catalogo dati.
Le connessioni utilizzate per creare risorse federate richiedono l'autorizzazione IAM `glue:PassConnection`.
**Richiesta**
+ `CatalogId`: stringa ID catalogo, 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).
L'ID del catalogo dati in cui creare la connessione. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `ConnectionInput` - *obbligatorio:* un oggetto [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput).
Un oggetto `ConnectionInput` che definisce la connessione da creare.
+ `Tags`: una matrice di mappe con coppie chiave-valore, non superiore alle 50 coppie.
Ogni chiave è una stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.
Ogni valore è una stringa UTF-8, lunga non più di 256 byte.
I tag assegnati alla connessione.
**Risposta**
+ `CreateConnectionStatus`: stringa UTF-8 (valori validi: `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).
Lo stato della richiesta di creazione della connessione. La richiesta può richiedere del tempo per determinati tipi di autenticazione, ad esempio quando si crea una OAuth connessione con token exchange tramite VPC.
**Errori**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
## DeleteConnection azione (Python: delete\$1connection)
Elimina una connessione 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
L'ID del catalogo dati in cui risiede la connessione. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `ConnectionName` - *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).
Nome della connessione da eliminare.
**Risposta**
+ *Nessun parametro di risposta.*
**Errori**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
## GetConnection azione (Python: get\$1connection)
Recupera una definizione di connessione 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
L'ID del catalogo dati in cui risiede la connessione. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `Name` - *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 della definizione di connessione da recuperare.
+ `HidePassword`: booleano.
Consente di recuperare i metadati di connessione senza restituire la password. Ad esempio, la AWS Glue console utilizza questo flag per recuperare la connessione e non visualizza la password. Imposta questo parametro quando il chiamante potrebbe non avere l'autorizzazione per utilizzare la AWS KMS chiave per decrittografare la password, ma dispone dell'autorizzazione per accedere al resto delle proprietà della connessione.
+ `ApplyOverrideForComputeEnvironment`: stringa UTF-8 (valori validi: `SPARK` \$1 `ATHENA` \$1 `PYTHON`).
Per le connessioni che possono essere utilizzate in più servizi, specifica le proprietà di restituzione per l'ambiente di calcolo specificato.
**Risposta**
+ `Connection`: un oggetto [Connessione](#aws-glue-api-catalog-connections-connections-Connection).
La definizione di connessione richiesta.
**Errori**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
## GetConnections azione (Python: get\$1connections)
Recupera un elenco di definizioni di connessione 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
L'ID del catalogo dati in cui risiedono le connessioni. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `Filter`: un oggetto [GetConnectionsFilter](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter).
Un filtro che controlla quali connessioni vengono restituite.
+ `HidePassword`: booleano.
Consente di recuperare i metadati di connessione senza restituire la password. Ad esempio, la AWS Glue console utilizza questo flag per recuperare la connessione e non visualizza la password. Imposta questo parametro quando il chiamante potrebbe non avere l'autorizzazione per utilizzare la AWS KMS chiave per decrittografare la password, ma dispone dell'autorizzazione per accedere al resto delle proprietà della connessione.
+ `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 1.000.
Il numero massimo di connessioni da restituire in una risposta.
**Risposta**
+ `ConnectionList`: una matrice di oggetti [Connessione](#aws-glue-api-catalog-connections-connections-Connection).
Un elenco di definizioni di connessione richieste.
+ `NextToken`: stringa UTF-8.
Un token di continuazione, se l'elenco di connessioni restituite non include l'ultima delle connessioni filtrate.
**Errori**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
## UpdateConnection azione (Python: update\$1connection)
Aggiorna una definizione di connessione 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
L'ID del catalogo dati in cui risiede la connessione. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `Name` - *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 della definizione di connessione da aggiornare.
+ `ConnectionInput` - *obbligatorio:* un oggetto [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput).
Un oggetto `ConnectionInput` che ridefinisce la connessione in questione.
**Risposta**
+ *Nessun parametro di risposta.*
**Errori**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
## TestConnection azione (Python: test\$1connection)
Verifica una connessione a un servizio per convalidare le credenziali del servizio fornite.
Puoi fornire un nome di connessione esistente o un `TestConnectionInput` per testare un input di connessione inesistente. La fornitura di entrambi nello stesso momento genera un errore.
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
**Richiesta**
+ `ConnectionName`: 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).
Opzionale. Il nome della connessione da testare. Se viene fornito solo il nome, l'operazione otterrà la connessione e la utilizzerà per il test.
+ `CatalogId`: stringa ID catalogo, 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).
L'ID del catalogo in cui si trova la connessione.
+ `TestConnectionInput`: un oggetto [TestConnectionInput](#aws-glue-api-catalog-connections-connections-TestConnectionInput).
Una struttura utilizzata per specificare il test di una connessione a un servizio.
**Risposta**
+ *Nessun parametro di risposta.*
**Errori**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ConflictException`
+ `InternalServiceException`
## BatchDeleteConnection azione (Python: batch\$1delete\$1connection)
Elimina un elenco di definizioni di connessione 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
L'ID del catalogo dati in cui risiedono le connessioni. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `ConnectionNameList`: *obbligatorio:* matrice di stringhe UTF-8, non superiore a 25 stringhe.
Un elenco di nomi delle connessioni da eliminare.
**Risposta**
+ `Succeeded`: una matrice di stringhe UTF-8.
Un elenco di nomi delle definizioni di connessione la cui eliminazione è riuscita.
+ `Errors`: una matrice della mappa di coppie chiave-valore.
Ogni chiave è una 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).
Ogni valore è un oggetto [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).
Una mappa dei nomi delle connessioni la cui eliminazione non è riuscita per i dettagli di errore.
**Errori**
+ `InternalServiceException`
+ `OperationTimeoutException`
# 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\$1connection\$1type)](#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType)
+ [ListConnectionTypes azione (Python: list\$1connection\$1types)](#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\$1connection\$1type)
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\$1connection\$1types)
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` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` `DYNAMODB` `GOOGLECLOUDSTORAGE`\$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1`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` \$1 `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` \$1 `ATHENA` \$1 `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.
# Metadati di connessione e API di anteprima
La seguente connessione APIs descrive le operazioni per descrivere i metadati di connessione.
## Tipi di dati
+ [Struttura dell'entità](#aws-glue-api-catalog-connections-connections-metadata-Entity)
+ [Struttura del campo](#aws-glue-api-catalog-connections-connections-metadata-Field)
## Struttura dell'entità
Un'entità supportata da un dato `ConnectionType`.
**Campi**
+ `EntityName`: stringa UTF-8.
Il nome dell'entità.
+ `Label`: stringa UTF-8.
Etichetta utilizzata per l'entità.
+ `IsParentEntity`: booleano.
Un valore booleano che aiuta a determinare se ci sono oggetti secondari che possono essere elencati.
+ `Description`: stringa UTF-8.
Una descrizione dell'entità.
+ `Category`: stringa UTF-8.
Il tipo di entità presenti nella risposta. Questo valore dipende dalla connessione di origine. Ad esempio, questo è `SObjects` per Salesforce e `databases`, `schemas` o `tables` per origini come Amazon Redshift.
+ `CustomProperties` –
Una mappa facoltativa di chiavi che può essere restituita per un'entità da un connettore.
## Struttura del campo
L'oggetto `Field` contiene informazioni sulle diverse proprietà associate a un campo nel connettore.
**Campi**
+ `FieldName`: stringa UTF-8.
L'identificatore univoco del campo.
+ `Label`: stringa UTF-8.
Un'etichetta leggibile utilizzata per il campo.
+ `Description`: stringa UTF-8.
Una descrizione del campo.
+ `FieldType`: stringa UTF-8 (valori validi: `INT` \$1 `SMALLINT` \$1 `BIGINT` \$1 `FLOAT` \$1 `LONG` \$1 `DATE` \$1 `BOOLEAN` \$1 `MAP` \$1 `ARRAY` \$1 `STRING` \$1 `TIMESTAMP` \$1 `DECIMAL` \$1 `BYTE` \$1 `SHORT` \$1 `DOUBLE` \$1 `STRUCT`).
Il tipo di dati nel campo.
+ `IsPrimaryKey`: booleano.
Indica se questo campo può essere utilizzato come chiave primaria per l'entità specificata.
+ `IsNullable`: booleano.
Indica se questo campo può essere annullabile o meno.
+ `IsRetrievable`: booleano.
Indica se questo campo può essere aggiunto nella clausola Select della query SQL o se è recuperabile o meno.
+ `IsFilterable`: booleano.
Indica se questo campo può essere utilizzato in una clausola di filtro (clausola `WHERE`) di un'istruzione SQL durante l'esecuzione di query sui dati.
+ `IsPartitionable`: booleano.
Indica se un determinato campo può essere utilizzato per partizionare la query eseguita su SaaS.
+ `IsCreateable`: booleano.
Indica se questo campo può essere creato come parte di una scrittura di destinazione.
+ `IsUpdateable`: booleano.
Indica se questo campo può essere aggiornato come parte di una scrittura di destinazione.
+ `IsUpsertable`: booleano.
Indica se questo campo può essere alterato come parte di una scrittura di destinazione.
+ `IsDefaultOnCreate`: booleano.
Indica se questo campo viene compilato automaticamente al momento della creazione dell'oggetto, ad esempio un timestamp Ora di creazione.
+ `SupportedValues` – .
Un elenco di valori supportati per il campo.
+ `SupportedFilterOperators`: una matrice di stringhe UTF-8.
Indica gli operatori di filtro di supporto per questo campo.
+ `CustomProperties` –
Mappa opzionale delle chiavi che possono essere restituite.
## Operazioni
+ [ListEntities azione (Python: list\$1entities)](#aws-glue-api-catalog-connections-connections-metadata-ListEntities)
+ [DescribeEntity azione (Python: describe\$1entity)](#aws-glue-api-catalog-connections-connections-metadata-DescribeEntity)
+ [GetEntityRecords azione (Python: get\$1entity\$1records)](#aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords)
## ListEntities azione (Python: list\$1entities)
Restituisce le entità disponibili supportate dal tipo di connessione.
**Richiesta**
+ `ConnectionName`: 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).
Un nome per la connessione che ha bisogno di credenziali per eseguire query su qualsiasi tipo di connessione.
+ `CatalogId`: stringa ID catalogo, 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).
L'ID del catalogo che contiene la connessione. Questo può essere nullo. Per impostazione predefinita, l'ID AWS account è l'ID del catalogo.
+ `ParentEntityName`: stringa UTF-8.
Il nome dell'entità padre per la quale intendi elencare i figli. Questo parametro utilizza un percorso completo dell'entità per elencare le entità figlio.
+ `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, incluso se si tratta di una chiamata di continuazione.
+ `DataStoreApiVersion`: stringa UTF-8, non inferiore a 1 o superiore a 256 byte di lunghezza, corrispondente a [Custom string pattern #23](aws-glue-api-common.md#regex_23).
La versione API del connettore SaaS.
**Risposta**
+ `Entities`: una matrice di oggetti [Entità](#aws-glue-api-catalog-connections-connections-metadata-Entity).
Elenco di oggetti `Entity`.
+ `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, presente se il segmento corrente non è l'ultimo.
**Errori**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`
## DescribeEntity azione (Python: describe\$1entity)
Fornisce dettagli sull'entità utilizzata con il tipo di connessione, con una descrizione del modello di dati per ogni campo dell'entità selezionata.
La risposta include tutti i campi che compongono l'entità.
**Richiesta**
+ `ConnectionName` - *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 della connessione che contiene le credenziali del tipo di connessione.
+ `CatalogId`: stringa ID catalogo, 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).
L'ID del catalogo che contiene la connessione. Questo può essere nullo. Per impostazione predefinita, l'ID AWS account è l'ID del catalogo.
+ `EntityName` - *Obbligatorio:* stringa UTF-8.
Il nome dell'entità che desideri descrivere in base al tipo di connessione.
+ `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, incluso se si tratta di una chiamata di continuazione.
+ `DataStoreApiVersion`: stringa UTF-8, non inferiore a 1 o superiore a 256 byte di lunghezza, corrispondente a [Custom string pattern #23](aws-glue-api-common.md#regex_23).
La versione dell'API utilizzata per il datastore.
**Risposta**
+ `Fields`: una matrice di oggetti [Campo](#aws-glue-api-catalog-connections-connections-metadata-Field).
Descrive i campi per tale entità del connettore. Questo è l'elenco degli oggetti `Field`. `Field` è molto simile alla colonna in un database. L'oggetto `Field` contiene informazioni sulle diverse proprietà associate ai campi del connettore.
+ `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, presente se il segmento corrente non è l'ultimo.
**Errori**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`
## GetEntityRecords azione (Python: get\$1entity\$1records)
Questa API viene utilizzata per interrogare i dati di anteprima da un determinato tipo di connessione o da un catalogo AWS Glue dati nativo basato su Amazon S3.
Restituisce i record sotto forma di un array di blob JSON. Ogni record è formattato utilizzando Jackson JsonNode in base al tipo di campo definito dall'`DescribeEntity`API.
I connettori Spark generano schemi in base alla stessa mappatura dei tipi di dati dell'API `DescribeEntity`. I connettori Spark convertono i dati nei tipi di dati appropriati che corrispondono allo schema quando restituiscono le righe.
**Richiesta**
+ `ConnectionName`: 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 della connessione che contiene le credenziali del tipo di connessione.
+ `CatalogId`: stringa ID catalogo, 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).
L'ID del catalogo che contiene la connessione. Questo può essere nullo. Per impostazione predefinita, l'ID AWS account è l'ID del catalogo.
+ `EntityName` - *Obbligatorio:* stringa UTF-8.
Nome dell'entità per cui vogliamo eseguire le query sui dati di anteprima relativi al tipo di connessione specificato.
+ `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, incluso se si tratta di una chiamata di continuazione.
+ `DataStoreApiVersion`: stringa UTF-8, non inferiore a 1 o superiore a 256 byte di lunghezza, corrispondente a [Custom string pattern #23](aws-glue-api-common.md#regex_23).
La versione API del connettore SaaS.
+ `ConnectionOptions`: una matrice di mappe con coppie chiave-valore, non superiore alle 100 coppie.
Ogni chiave è una stringa UTF-8, non inferiore a 1 o superiore a 256 byte di lunghezza, corrispondente a [Custom string pattern #18](aws-glue-api-common.md#regex_18).
Ogni valore è una stringa UTF-8, non inferiore a 1 o superiore a 256 byte di lunghezza, corrispondente a [Custom string pattern #17](aws-glue-api-common.md#regex_17).
Opzioni di connettore necessarie per eseguire query sui dati.
+ `FilterPredicate`: stringa UTF-8, non inferiore a 1 o superiore a 100.000 byte di lunghezza.
Un predicato di filtro che puoi applicare nella richiesta di query.
+ `Limit`: *obbligatorio:* numero (long), non inferiore a 1 o superiore a 1.000.
Limita il numero di record recuperati con la richiesta.
+ `SelectedFields`: un array di stringhe UTF-8, non inferiore a 1 o superiore a 1.000 stringhe.
Elenco di campi da recuperare come parte dei dati di anteprima.
**Risposta**
+ `Records`: un array di strutture.
Un elenco di tutti gli oggetti richiesti.
+ `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, presente se il segmento corrente non è l'ultimo.
**Errori**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`