Utiliser l'interface CLI pour se connecter à Trino - E-MapReduce

Une fois le cluster créé avec le service Trino, utilisez l'interface en ligne de commande (CLI) pour vous y connecter et exécuter des requêtes de données simples et rapides.

Prérequis

Un cluster doit être créé avec le service Trino sélectionné. Pour plus d'informations sur la création d'un cluster, consultez la rubrique Créer un cluster.

Limites

Il est impossible d'activer simultanément Ranger et Kerberos sur un même cluster.

Clusters Data Lake et personnalisés

Remarque

L'activation de l'option Kerberos Authentication lors de la création du cluster génère un cluster hautement sécurisé. À défaut, un cluster standard est créé.

Clusters standards

Connectez-vous au cluster via SSH. Pour plus d'informations, consultez la rubrique Se connecter à un cluster.
Exécutez la commande suivante pour vous connecter à l'interface CLI Trino.

Remarque
Pour les versions EMR 3.44.0 et ultérieures ainsi que EMR 5.10.0 et ultérieures, la console affiche le service sous le nom Trino. Pour les versions antérieures à EMR 3.44.0 et EMR 5.10.0, la console affiche le service sous le nom Presto.
EMR 3.44.0 ou version ultérieure et EMR 5.10.0 ou version ultérieure
```
trino --server master-1-1:9090
```
Versions antérieures à EMR 3.44.0 et EMR 5.10.0
```
presto --server master-1-1:9090
```
Exécutez la commande suivante pour afficher les données de la table.
```
select * from <catalog>.<schema>.<table>;
```
Les paramètres de cette commande sont les suivants :
- <catalog> : nom de la source de données.
- <schema> : nom de la base de données.
- <table> : table à interroger.
  
  Par exemple, pour consulter les données de la table test située dans la base de données par défaut d'une source de données Hive, exécutez la commande select * from hive.default.test;.
Facultatif : Exécutez la commande quit; pour quitter l'interface CLI Trino.

Clusters hautement sécurisés

Connectez-vous au cluster via SSH. Pour plus d'informations, consultez la rubrique Se connecter à un cluster.

Exécutez la commande suivante pour vous connecter à l'interface CLI Trino.

EMR 3.44.0 ou version ultérieure et EMR 5.10.0 ou version ultérieure

trino --server https://${FQDN}:7778 \
       --krb5-config-path /etc/krb5.conf \
       --keystore-path /etc/emr/trino-conf/keystore \
       --keystore-password ${pwd} \
       --krb5-keytab-path /etc/emr/trino-conf/trino.keytab \
       --krb5-principal trino/${FQDN}@${REALM} \
       --krb5-remote-service-name trino \
       --user trino/${FQDN}
       --catalog ${CATALOG}

Versions antérieures à EMR 3.44.0 et EMR 5.10.0

Remarque

Pour les versions EMR 3.44.0 et ultérieures ainsi que EMR 5.10.0 et ultérieures, la console affiche le service sous le nom Trino. Pour les versions antérieures à EMR 3.44.0 et EMR 5.10.0, la console affiche le service sous le nom Presto.

presto --server https://${FQDN}:7778 \
       --krb5-config-path /etc/krb5.conf \
       --keystore-path /etc/emr/trino-conf/keystore \
       --keystore-password ${pwd} \
       --krb5-keytab-path /etc/emr/trino-conf/trino.keytab \
       --krb5-principal trino/${FQDN}@${REALM} \
       --krb5-remote-service-name trino \
       --user trino/${FQDN}

Paramètre

Description

${FQDN}

Nom de domaine complet (FQDN) du nœud master-1-1. Vous pouvez obtenir le FQDN en exécutant la commande hostname -f. Le format est le suivant : master-1-1.c-xxxxxxx.cn-xxxxxx.emr.aliyuncs.com.

--krb5-config-path

Valeur du paramètre http.authentication.krb5.config dans le fichier config.properties. La valeur est /etc/krb5.conf.

--keystore-path

Valeur du paramètre http-server.https.keystore.path dans le fichier config.properties. La valeur est /etc/emr/trino-conf/keystore.

--keystore-password

Valeur du paramètre http-server.https.keystore.key dans le fichier config.properties. Ce paramètre correspond à ${pwd}. Pour obtenir la valeur, exécutez la commande awk -F= '/http-server.https.keystore.key/{print $2}' ${TRINO_CONF_DIR}/config.properties sur le nœud master-1-1.

--krb5-keytab-path

Valeur du paramètre http-server.authentication.krb5.keytab dans le fichier config.properties. La valeur est /etc/emr/trino-conf/trino.keytab.

${REALM}

Royaume Kerberos, identifiable dans la propriété http-server.authentication.krb5.user-mapping.pattern du fichier config.properties. Dans EMR, le format du royaume est EMR.C-XXXXXX.COM.

--krb5-remote-service-name

Valeur du paramètre http-server.authentication.krb5.service-name dans le fichier config.properties. La valeur est trino.

${CATALOG}

Nom de la source de données à laquelle se connecter. Par exemple, spécifiez --catalog hive pour vous connecter à une source de données Hive.

Exécutez la commande suivante pour afficher les schémas du catalogue actuel.
```
show schemas;
```
Facultatif : Exécutez la commande quit; pour quitter l'interface CLI Trino.

Clusters Data Lake hérités (Hadoop)

Remarque

Sur les clusters Hadoop, la console EMR affiche le service sous le nom Presto.

Clusters standards

Connectez-vous au cluster via SSH. Pour plus d'informations, consultez la rubrique Se connecter à un cluster.
Exécutez la commande suivante pour vous connecter à l'interface CLI Presto.
```
presto --server emr-header-1:9090 --catalog hive --schema default --user hadoop
```
Les paramètres de cette commande sont les suivants :
- --server emr-header-1:9090 : adresse et port du serveur Presto.
- --catalog hive : nom de la source de données à laquelle se connecter. Dans cet exemple, la source de données est Hive. Modifiez cette valeur pour vous connecter à une autre source de données.
- --schema default : nom de la base de données ou du schéma à utiliser. Dans cet exemple, la base de données par défaut est utilisée. Adaptez ce paramètre selon vos besoins.
- --user hadoop : nom d'utilisateur pour l'authentification.
Exécutez la commande suivante pour afficher les schémas du catalogue actuel.
```
show schemas;
```
Facultatif : Exécutez la commande quit; pour quitter l'interface CLI Presto.

Clusters hautement sécurisés

Connectez-vous au cluster via SSH. Pour plus d'informations, consultez la rubrique Se connecter à un cluster.
Ajoutez un principal et exportez son fichier keytab.
1. Exécutez la commande suivante pour démarrer l'outil d'administration Kerberos.
  - EMR 3.30.0 ou version ultérieure et EMR 4.5.1 ou version ultérieure :
    sh /usr/lib/has-current/bin/admin-local.sh /etc/ecm/has-conf -k /etc/ecm/has-conf/admin.keytab
  - Versions antérieures à EMR 3.30.0 et EMR 4.5.1 :
    sh /usr/lib/has-current/bin/hadmin-local.sh /etc/ecm/has-conf -k /etc/ecm/has-conf/admin.keytab
2. Exécutez la commande suivante pour ajouter un principal avec une clé aléatoire.
```
addprinc -randkey test
```
  Remarque
  Cet exemple ajoute un principal nommé test.
3. Exécutez la commande suivante pour exporter le fichier keytab.
```
xst -k /home/test.keytab test
```
  Par défaut, le fichier keytab est exporté vers le répertoire /home/.

Exécutez la commande suivante pour accéder à l'interface CLI Presto.

presto --server https://<hostname>:7778 \
       --catalog hive \
       --schema default \
       --keystore-path /etc/ecm/presto-conf/keystore \
       --keystore-password <passwd> \
       --krb5-keytab-path <keytab_file> \
       --krb5-principal <username>@EMR.<cluster_id>.COM \
       --krb5-remote-service-name presto \
       --user <username>

Paramètre

Description

<hostname>

Nom d'hôte. Pour l'obtenir, exécutez la commande hostname sur le nœud emr-header-1. Le format est emr-header-1.cluster-xxx.

<passwd>

Mot de passe. Pour l'obtenir, exécutez la commande sed -n 's/http-server.https.keystore.key=$[^;]*$/\1/p' /etc/ecm/presto-conf/config.properties sur le nœud emr-header-1.

<keytab_file>

Chemin d'accès au fichier keytab exporté. Dans cet exemple, le chemin est /home/test.keytab.

<username>

Principal associé au fichier keytab. Dans cet exemple, le principal est test.

<cluster_id>

ID du cluster. Pour l'obtenir, exécutez la commande `hostname

grep -Eo '[0-9]+$'` sur le nœud emr-header-1.

Exécutez la commande suivante pour afficher les schémas du catalogue actuel.
```
show schemas;
```
Facultatif : Exécutez la commande quit; pour quitter l'interface CLI Presto.

Documentation connexe

Pour des requêtes, analyses et traitements de données complexes, ou pour intégrer les résultats de requête dans une application Java, connectez-vous à Trino via JDBC. Pour plus d'informations, consultez la rubrique Se connecter à Trino via JDBC.