As conexões de dados no Editor da carga de dados e no Script permitem salvar atalhos para as fontes de dados que você usa frequentemente: bancos de dados, arquivos locais ou arquivos remotos.
Conexões de dados lista as conexões salvas em ordem alfabética, agrupadas pelos espaços aos quais elas pertencem. É possível usar a caixa de pesquisa para reduzir a lista às conexões com um determinado nome ou tipo. Você pode acessar Conexões de dados clicando em Fontes de dados.
Criando uma nova conexão de dados
Faça o seguinte:
-
Clique em Fontes de dados.
- Clique em Criar nova conexão.
-
Em Espaço, selecione o espaço onde a conexão será localizada.
-
Selecione o tipo de fonte de dados que você deseja criar na lista suspensa.
O diálogo de configurações, específico do tipo de fonte de dados que você selecionou, é aberto.
-
Digite as configurações da fonte de dados e clique em Create para criar a conexão de dados.
Excluindo uma conexão de dados
Faça o seguinte:
Clique em Fontes de dados.
- Clique em
na conexão de dados que deseja excluir. - Confirme que você deseja excluir a conexão.
A conexão de dados é excluída.
Editando uma conexão de dados
Faça o seguinte:
Clique em Fontes de dados.
Em Conexões de dados, selecione o espaço que contém a conexão de dados que você deseja editar.
- Clique em
na conexão de dados que deseja editar. Edite os detalhes da conexão de dados. Os detalhes da conexão são específicos para o tipo de conexão.
Pode ser necessário fornecer as credenciais da conexão.
A conexão de dados é atualizada.
Sobre as conexões de DataFiles
As conexões de DataFiles são criadas automaticamente para cada espaço que você pode acessar. As conexões estão disponíveis em cada seção de espaço em Conexões de dados.
Selecionando dados de uma conexão de dados
Se você quiser selecionar dados de uma conexão de dados para carregar em seu aplicativo, faça o seguinte:
Clique em Fontes de dados.
- Criar nova conexão para vincular à fonte de dados (caso a conexão de dados ainda não exista).
Selecionar dados da conexão.
Fazendo referência a uma conexão de dados no script
Você pode usar a conexão de dados para se referir a fontes de dados em comandos e funções no script, geralmente onde você quiser criar uma referência a um nome de arquivo com um caminho.
No Qlik Cloud Analytics, a sintaxe para fazer referência a um arquivo no script de carregamento é:
[lib://(nome_do_espaço):(nome_da_conexão)/(nome_da_pasta)/(nome_do_arquivo)]
O caminho completo da pasta deve ser fornecido. Não são aceitos caminhos relativos.
Se o espaço não existir, a instrução não poderá ser executada e retornará um erro.
O caminho da pasta pode incluir várias pastas em uma estrutura hierárquica. Cada nome_da_pasta no caminho deve ser delimitado com os caracteres /.
Os itens a seguir não são permitidos no caminho ao fazer referência a arquivos que residem em uma estrutura de pastas:
//
\
\\
/./
/../
Os símbolos de ponto final (.) no espaço, na pasta ou no nome do arquivo são aceitáveis, desde que não apareçam nas configurações da lista acima.
Exemplos: Sintaxe não compatível
Estes exemplos são considerados sintaxe inválida para o caminho:
Dependendo do tipo de instrução de script que está sendo usada, a sintaxe fora de conformidade pode causar falha de recarregamento ou ainda pode ser executada com um comportamento diferente. Para obter detalhes específicos, consulte:
Você não precisa adicionar o space_name se estiver se conectando a um espaço pessoal.
Exemplo: Carregando um arquivo de uma conexão de DataFiles
Esse exemplo carrega o arquivo orders.csv desde um espaço pessoal definido na conexão de dados Data.
LOAD * FROM [lib://DataFiles/orders.csv];Esse exemplo carrega o arquivo orders.csv de um espaço compartilhado definido na conexão de dados Data.
LOAD * FROM [lib://TeamSharedConnection:DataFiles/orders.csv];Esse exemplo carrega o arquivo orders_Europe.csv da pasta Orders By Region em um espaço pessoal.
LOAD * FROM [lib://DataFiles/Orders By Region/orders_Europe.csv];Esse exemplo carrega o arquivo orders_Europe.csv da pasta Orders By Region em um espaço compartilhado, um espaço gerenciado ou um espaço de dados. O nome do espaço é SalesSpace.
LOAD * FROM [lib://SalesSpace:DataFiles/Orders By Region/orders_Europe.csv];Esse exemplo carrega o arquivo orders.csv do espaço atual. Se o aplicativo for movido para outro espaço, por exemplo, ele usará o arquivo orders.csv no novo espaço.
LOAD * FROM [lib://:DataFiles/orders.csv];Exemplo: Carregando de um banco de dados no espaço pessoal do usuário atual
Esse exemplo carrega a tabela Sales_data da conexão de banco de dados DataSource no espaço pessoal de um usuário.
LIB CONNECT TO 'DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;Exemplo: Carregando de um banco de dados em outro espaço
Esse exemplo carrega a tabela Sales_data da conexão de banco de dados DataSource no espaço atual.
LIB CONNECT TO ':DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;Exemplo: Carregando de um banco de dados em um espaço específico
Esse exemplo carrega a tabela Sales_data da conexão de banco de dados DataSource no espaço SalesSpace.
LIB CONNECT TO 'SalesSpace:DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;Exemplos: Carregando de conexões analíticas
Os exemplos a seguir mostram como escrever expressões para carregar dados de conexões analíticas. Use a sintaxe SSE para conectar-se aos dados de uma conexão analítica.
Estes exemplos demonstram o uso das conexões em scripts. Para obter exemplos que mostram como fazer referência a conexões analíticas em gráficos, consulte Usando conexões analíticas e sintaxe de extensões no lado do servidor.
Carregando de uma conexão analítica no espaço atual
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":":Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});Carregando de uma conexão analítica no espaço pessoal do usuário atual
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});Carregando de uma conexão analítica em um espaço específico
Este exemplo carrega dados da conexão nomeada Amazon_Titan_(Amazon_Bedrock) no espaço SalesSpace.
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"SalesSpace:Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});