Connectez-vous à l'aide du pilote ODBC Amazon DocumentDB

Le pilote ODBC pour Amazon DocumentDB fournit une interface SQL relationnelle aux développeurs et permet la connectivité à partir d'outils de BI tels que Power BI Desktop et Microsoft Excel.

Pour plus d'informations, consultez la documentation du pilote ODBC Amazon DocumentDB sur. GitHub

Rubriques

• Premiers pas

• Configuration du pilote ODBC Amazon DocumentDB sous Windows

• Connectez-vous à Amazon DocumentDB depuis Microsoft Excel

• Connectez-vous à Amazon DocumentDB depuis Microsoft Power BI Desktop

• Génération automatique de schémas

• Support et limites du SQL

• Résolution des problèmes

Premiers pas

Étape 1. Création de clusters Amazon DocumentDB

Si vous ne possédez pas encore de cluster Amazon DocumentDB, il existe plusieurs méthodes pour démarrer.

Note

Amazon DocumentDB est un service réservé au Virtual Private Cloud (VPC). Si vous vous connectez depuis une machine locale extérieure au VPC du cluster, vous devez créer une connexion SSH vers une instance Amazon. EC2 Dans ce cas, lancez votre cluster en suivant les instructions de la section Connect with EC2. Consultez Utiliser un tunnel SSH pour vous connecter à Amazon DocumentDB pour plus d'informations sur le tunneling SSH et savoir quand vous pourriez en avoir besoin.

Étape 2. Installation de JRE ou de JDK

En fonction de votre application BI, vous devrez peut-être vous assurer qu'une installation JRE ou JDK 64 bits version 8 ou ultérieure est installée sur votre ordinateur. Vous pouvez télécharger le Java SE Runtime Environment 8 ici.

Étape 3. Téléchargez le pilote ODBC Amazon DocumentDB

Téléchargez le pilote ODBC Amazon DocumentDB ici. Choisissez le programme d'installation approprié (par exemple, documentdb-odbc-1.0.0.msi). Suivez le guide d'installation.

Étape 4. Utilisation d'un tunnel SSH pour se connecter à Amazon DocumentDB

Les clusters Amazon DocumentDB sont déployés au sein d'un Amazon Virtual Private Cloud (Amazon VPC). Ils sont accessibles directement par les EC2 instances Amazon ou d'autres AWS services déployés dans le même Amazon VPC. En outre, Amazon DocumentDB est accessible par des EC2 instances Amazon ou d'autres AWS services situés dans différentes régions de la même AWS région ou VPCs dans d'autres régions via le peering VPC.

Supposons toutefois que votre cas d'utilisation nécessite que vous (ou votre application) accédiez à vos ressources Amazon DocumentDB en dehors du VPC du cluster. Ce sera le cas pour la plupart des utilisateurs qui n'exécutent pas leur application sur une machine virtuelle dans le même VPC que le cluster Amazon DocumentDB. Lorsque vous vous connectez depuis l'extérieur du VPC, vous pouvez utiliser le tunneling SSH (également appelé redirection de port) pour accéder à vos ressources Amazon DocumentDB.

Pour créer un tunnel SSH, vous avez besoin d'une EC2 instance Amazon exécutée dans le même Amazon VPC que votre cluster Amazon DocumentDB. Vous pouvez soit utiliser une EC2 instance existante dans le même VPC que votre cluster, soit en créer une. Vous pouvez configurer un tunnel SSH vers le sample-cluster.node.us-east-1.docdb.amazonaws.com cluster Amazon DocumentDB en exécutant la commande suivante sur votre ordinateur local :

ssh -i "ec2Access.pem" -L 27017:sample-cluster.node.us-east-1.docdb.amazonaws.com:27017 [e-mail] -N

L'indicateur -L est utilisé pour réacheminer un port local. Il s'agit d'une condition préalable à la connexion à tout outil de BI exécuté sur un client extérieur à votre VPC. Une fois que vous avez exécuté l'étape ci-dessus, vous pouvez passer aux étapes suivantes pour l'outil de BI de votre choix.

Pour plus d'informations sur le tunneling SSH, consultez la documentation sur l'utilisation d'un tunnel SSH pour vous connecter à Amazon DocumentDB.