Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Mise en cache des connexions aux extensions SQL
<a name="sagemaker-sql-extension-features-connection-caching"></a>

L’extension SQL met par défaut les connexions en cache afin d’empêcher la création de plusieurs connexions pour le même ensemble de propriétés de connexion. Les connexions mises en cache peuvent être gérées à l’aide de la commande magique `%sm_sql_manage`.

Les rubriques suivantes décrivent comment gérer vos connexions mises en cache.

**Topics**
+ [Création de connexions mises en cache](sagemaker-sql-extension-features-create-cached-connection.md)
+ [Établissement de la liste des connexions mises en cache](sagemaker-sql-extension-features-list-cached-connection.md)
+ [Effacement des connexions mises en cache](sagemaker-sql-extension-features-clear-cached-connection.md)
+ [Désactivation des connexions mises en cache](sagemaker-sql-extension-features-disable-cached-connection.md)

# Création de connexions mises en cache
<a name="sagemaker-sql-extension-features-create-cached-connection"></a>

Vous pouvez créer des connexions mises en cache en spécifiant un nom de connexion dans le paramètre `--connection-name` de votre chaîne de connexion. Cela est particulièrement utile lorsque plusieurs propriétés de connexion sont remplacées pour un cas d’utilisation spécifique et qu’il est nécessaire de réutiliser les mêmes propriétés sans les retaper.

Par exemple, le code ci-dessous enregistre une connexion Athena avec une propriété de connexion au schéma remplacée en utilisant le nom `--connection-name my_athena_conn_with_schema`, puis la réutilise dans une autre cellule :

```
%%sm_sql --connection-name my_athena_conn_with_schema --connection-properties '{"schema_name": "sm-sql-private-beta-db"}' --metastore-id sm-sql-private-beta-athena-connection --metastore-type GLUE_CONNECTION 
SELECT * FROM "covid_table" LIMIT 2
```

```
%%sm_sql --connection-name my_athena_conn_with_schema
SELECT * FROM "covid_table" LIMIT 2
```

# Établissement de la liste des connexions mises en cache
<a name="sagemaker-sql-extension-features-list-cached-connection"></a>

Vous pouvez répertorier vos connexions mises en cache en exécutant la commande suivante :

```
%sm_sql_manage --list-cached-connections
```

# Effacement des connexions mises en cache
<a name="sagemaker-sql-extension-features-clear-cached-connection"></a>

Pour effacer toutes les connexions mises en cache, exécutez la commande suivante :

```
%sm_sql_manage --clear-cached-connections
```

# Désactivation des connexions mises en cache
<a name="sagemaker-sql-extension-features-disable-cached-connection"></a>

Pour désactiver la mise en cache des connexions, exécutez la commande suivante :

```
%sm_sql_manage --set-connection-reuse False
```