O InstanceTunnel permite baixar os resultados da execução de uma instância SQL referente a instruções SELECT.
Definição e descrição da API do InstanceTunnel
A definição da API do InstanceTunnel é apresentada abaixo. Para mais detalhes, consulte Java-sdk-doc.
public class InstanceTunnel{
public DownloadSession createDownloadSession(String projectName, String instanceID);
public DownloadSession createDownloadSession(String projectName, String instanceID, boolean limitEnabled);
}Descrição dos parâmetros:
projectName: Nome do projeto.
instanceID: ID da instância. Para visualizar o ID da instância, consulte Operações de instância.
Restrições e limites do InstanceTunnel
Embora o InstanceTunnel ofereça uma maneira prática de obter resultados da execução de instâncias, essa funcionalidade possui restrições de permissão para garantir a segurança dos dados.
Em downloads com até 10.000 registros, basta que o usuário tenha permissão de leitura (Read) na instância. Esse comportamento corresponde ao da REST API para obtenção de dados de consulta.
Se o volume de dados ultrapassar 10.000 registros, o sistema verificará as permissões em todas as tabelas de origem referenciadas na consulta SQL da instância. Nesse caso, o usuário precisará ter permissão de leitura (Read) em todas essas tabelas.
O uso de um endpoint público gera custos de download. Para verificar os endereços de endpoint público, consulte Endpoint.
Caso a verificação de permissão de download esteja ativada em um endpoint público, será necessária a permissão específica de Download para acessar os dados. Consulte Controle de permissão de download para obter detalhes sobre a autorização.