Cette rubrique explique comment utiliser InstanceTunnel pour télécharger les résultats d'exécution d'une instruction SELECT.
Description
L'extrait de code suivant présente InstanceTunnel. Pour plus d'informations, consultez la documentation Java-sdk-doc.
public class InstanceTunnel{
public DownloadSession createDownloadSession(String projectName, String instanceID);
public DownloadSession createDownloadSession(String projectName, String instanceID, boolean limitEnabled);
}
Paramètres :
projectName : nom du projet.
instanceID : ID de l'instance. Pour savoir comment afficher les ID des instances, consultez la section Opérations sur les instances.
Limites
InstanceTunnel offre un moyen simple d'obtenir les résultats d'exécution des instances. Toutefois, afin de garantir la sécurité des données, cette fonctionnalité est soumise aux limites d'autorisations suivantes :
Si le nombre d'enregistrements ne dépasse pas 10 000, tous les utilisateurs disposant d'autorisations en lecture sur l'instance spécifique peuvent utiliser InstanceTunnel pour télécharger les données. La même règle s'applique aux requêtes de données effectuées via un appel d'API RESTful.
Si le nombre d'enregistrements dépasse 10 000, seuls les utilisateurs disposant d'autorisations en lecture sur toutes les tables source incluses dans l'instruction SQL peuvent utiliser InstanceTunnel pour télécharger les données.
Si vous accédez à un endpoint public (pour obtenir la liste des adresses d'endpoints publics, consultez la section Endpoint), des frais de téléchargement vous seront facturés .
Si la fonctionnalité de contrôle des téléchargements est activée, les utilisateurs qui téléchargent des données via des endpoints publics doivent disposer des autorisations de téléchargement correspondantes. Pour plus d'informations sur l'attribution des autorisations, consultez la section Contrôle des autorisations de téléchargement.