Téléchargez les résultats d'exécution des instances SQL générées par des instructions SELECT via InstanceTunnel.
Définition et description de l'interface InstanceTunnel
L'interface InstanceTunnel se définit comme suit. Pour plus de détails, 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 de l'espace de projet.
instanceID : ID de l'instance. Pour consulter l'ID de l'instance, reportez-vous à la section Instance operations.
Contraintes et limitations d'InstanceTunnel
InstanceTunnel offre un moyen pratique d'obtenir les résultats d'exécution d'une instance, mais cette fonctionnalité est soumise à des restrictions d'autorisation pour protéger vos données.
Lors du téléchargement de données via InstanceTunnel, si le nombre d'enregistrements ne dépasse pas 10 000, tout utilisateur disposant de l'autorisation Read sur cette instance peut utiliser le service. Ce comportement est identique à celui de l'obtention de données de requête via l'API RESTful.
Si le nombre d'enregistrements dépasse 10 000 lors d'un téléchargement avec InstanceTunnel, le système vérifie les autorisations sur toutes les tables sources mentionnées dans l'instruction SQL de l'instance. L'utilisateur doit disposer de l'autorisation Read sur toutes les tables sources pour pouvoir télécharger les données.
Si vous utilisez un endpoint public (pour connaître l'adresse publique spécifique, consultez la section Endpoint), des frais de téléchargement s'appliquent .
Lorsqu'un utilisateur télécharge des données via un endpoint public et que la vérification des autorisations de téléchargement est activée, il doit disposer des autorisations appropriées. Pour le détail des autorisations, consultez la section Download permission control.