DCM - Designer
O Gerenciador de Conexões de Dados (DCM) é um armazenamento centralizado para conexões interoperáveis de banco de dados e nuvem (credenciais vinculadas a fontes de dados) que facilita o gerenciamento de conexões de fluxos de trabalho e a colaboração entre os produtos Alteryx. Use o DCM para inserir e usar suas conexões e credenciais entre ferramentas e fluxos de trabalho.
Com o DCM , você pode gerenciar fontes de dados, credenciais e conexões:
Os objetos de fonte de dados representam bancos de dados, serviços em nuvem e muito mais.
Os objetos de credencial representam combinações de nome de usuário e senha e tokens OAuth.
Os objetos de conexão unem as fontes de dados às credenciais e são usados por uma ou várias ferramentas em seu fluxo de trabalho.
Acesse Conectores e ferramentas com suporte para obter mais informações.
Configuração do Gerenciador de Conexões de Dados
Configurações de administrador
Há uma opção para alterar o Modo do DCM e escolher o Modo de acesso SDK .
As seguintes opções estão disponíveis via DCM Mode (modo do DCM) para definir o tratamento e o armazenamento de credenciais:
DCM Optional (DCM opcional): as conexões (incluindo senhas) são armazenadas em um fluxo de trabalho por padrão. Você pode optar por armazenar e gerenciar conexões no DCM.
DCM as Default (DCM por padrão): as conexões (incluindo senhas) são armazenadas e gerenciadas no DCM por padrão. Você pode optar por armazená-las em um fluxo de trabalho.
DCM Only (somente DCM): você não pode configurar conexões em um fluxo de trabalho. Você pode apenas selecionar conexões armazenadas no DCM. Fluxos de trabalho com senhas incorporadas podem ser executados.
DCM Enforced (DCM obrigatório): os fluxos de trabalho com senhas incorporadas não funcionam.
Em relação ao suporte a ferramentas SDK (Gallery), estas são opções administrativas:
Deny (negar): não há suporte para ferramentas SDK e a caixa de seleção Permitir credencial para ferramentas SDK não é exibida na IU de credenciais.
Allow (permitir): há suporte para ferramentas SDK e a caixa de seleção Permitir credencial para ferramentas SDK é exibida na IU com a opção de seleção manual de cada credencial.
AllowAll (permitir tudo): há suporte para ferramentas SDK e a caixa de seleção Permitir credencial para ferramentas SDK não é exibida na IU de credenciais.
Configurações de usuário
Como usuário, você pode alterar o Modo DCM e escolher o Modo de acesso SDK nas configurações de usuário do Designer. Acesse Opções > Configurações de usuário > Editar configurações de usuário . Em seguida, na guia Geral , role a tela até a seção Substituir configurações do DCM .
As seguintes opções estão disponíveis via Modo do DCM para definir o tratamento e o armazenamento de credenciais:
DCM opcional : as conexões (incluindo senhas) são armazenadas em um fluxo de trabalho por padrão. Você pode optar por armazenar e gerenciar conexões no DCM.
DCM por padrão : as conexões (incluindo senhas) são armazenadas e gerenciadas no DCM por padrão. Você pode optar por armazená-las em um fluxo de trabalho.
Somente DCM : você não pode configurar conexões em um fluxo de trabalho. Você pode apenas selecionar conexões armazenadas no DCM. Fluxos de trabalho com senhas incorporadas podem ser executados.
DCM obrigatório : os fluxos de trabalho com senhas incorporadas não funcionam.
Para o Modo de acesso SDK , estas são as opções disponíveis:
Negar : não há suporte para ferramentas SDK, e a caixa de seleção Permitir credencial para ferramentas SDK não é exibida na IU de credenciais.
Permitir : há suporte para ferramentas SDK, e a caixa de seleção Permitir credencial para ferramentas SDK é exibida na IU com a opção de seleção manual de cada credencial.
Permitir tudo : há suporte para ferramentas SDK, e a caixa de seleção Permitir credencial para ferramentas SDK não é exibida na IU de credenciais.
Gerenciador de Conexões
Você pode controlar as fontes de dados e credenciais que as autenticam no Gerenciador de Conexões. Além disso, você pode vincular o Designer Desktop ao Alteryx Analytics Cloud Platform (AACP). Acesse Arquivo > Gerenciar conexões para acessar esses recursos.
Gerenciar fontes de dados
Para adicionar uma fonte de dados no Gerenciador de Conexões...
Navegue até Fontes de dados .
Clique em + Novo .
Escolha a Tecnologia .
Insira as informações necessárias para a tecnologia que deseja conectar. Opcionalmente, você pode usar o botão Testar conexão .
Clique em Salvar .
Você pode combinar a fonte de dados com a credencial para criar uma conexão. Na seção Fontes de dados > Conexões , você pode ver a lista de credenciais vinculadas à conexão ou vincular uma nova credencial:
Clique em + Conectar credencial .
Escolha um Método de autenticação .
Insira as informações da credencial.
Opcionalmente, você pode escolher Permitir conexão para SDK .
Você pode clicar em Testar conexão ou em Criar e vincular para concluir.
Gerenciar credenciais
Para adicionar uma credencial no Gerenciador de Conexões, acesse a seção Credenciais . Você tem estas opções disponíveis:
Adicionar credenciais : selecione + Novo . Insira o Nome da credencial . Selecione um Método . Insira as informações necessárias (por exemplo, ID do cliente, chave secreta, nome de usuário e senha) para o método selecionado. Clique em Salvar .
Exibir credenciais : selecione na lista a credencial que deseja visualizar.
Editar credencial : para editar uma credencial no Gerenciador de Conexões, selecione na lista a credencial que deseja editar. Clique em Editar . Clique em Salvar .
Excluir credencial : selecione a credencial que você deseja excluir no Gerenciador de Conexões. Selecione o ícone de lixeira . Clique em Excluir .
Para se conectar à conexão, coloque a ferramenta na tela do fluxo de trabalho do Designer e selecione Configurar uma conexão . Na janela do Gerenciador de Conexões, escolha sua conexão e use as credenciais vinculadas selecionando o botão Conectar .
Manage External Vaults
The External Vault feature allows you to connect DCM with your Vault of choice. Thus, you can use External Vaults in DCM to fetch credentials from your Vault and securely use them in your workflow. For more information, go to DCM External Vaults.
Gerenciar links Alteryx
Os links Alteryx permitem vincular o Designer Desktop a um espaço de trabalho do Alteryx Analytics Cloud Platform (AACP) para que você possa salvar e executar na nuvem os fluxos criados no Desktop. Saiba mais sobre esses recursos em Execução no Cloud para o Desktop .
Criar um link Alteryx
Para vincular o Designer Desktop ao AACP, siga estas etapas:
No Designer Desktop, selecione Arquivo > Gerenciar conexões para abrir o DCM.
Selecione "Links Alteryx" no menu do lado esquerdo e clique no botão + Novo .
O Analytics Cloud é a Tecnologia padrão. Forneça as informações necessárias:
Nome da fonte de dados : este é o nome de exibição (rótulo) deste vínculo. O nome é exibido nos menus Salvar como e Abrir e ajuda os usuários a identificar essa conexão.
URL base : este é o URL usado para acessar o Alteryx Analytics Cloud (por exemplo, https://empresa.alteryxcloud.com/). Entre em contato com seu administrador do AACP para obter essas informações.
Nome do espaço de trabalho : este é o nome do espaço de trabalho do Analytics Cloud, como aparece no URL (após o URL base). Por exemplo, digamos que você acesse o Analytics Cloud via https://empresa.alteryxcloud.com/?workspace=meu-espaço-de-trabalho. Nesse caso, você digitaria "meu-espaço-de-trabalho" no campo Nome do espaço de trabalho . Entre em contato com seu administrador do AACP para obter essas informações.
Clique em Salvar . Em seguida, você precisa vincular credenciais.
Clique em + Conectar credencial para iniciar.
O recurso de execução no Cloud para o Desktop é compatível com o método de autenticação OpenID Connect (OIDC). Essa opção está pré-selecionada na lista suspensa Método de autenticação .
Na seção "TOKENS OIDC", use a lista suspensa Credencial para escolher uma credencial existente ou selecione Criar nova credencial .
Se precisar criar uma nova credencial, digite um Nome da credencial . Este é um rótulo que deve ajudá-lo a identificar essa credencial no futuro.
O Cofre está definido como "DCM" por padrão.
Opcionalmente, clique em Testar conexão ou clique em Criar e vincular para concluir.
Importante
Se a conexão falhar, verifique se o URL base e o nome do espaço de trabalho para a conexão com o AACP estão corretos.
Depois de conectar com êxito o Designer Desktop a um espaço de trabalho do AACP, os detalhes da conexão estarão disponíveis em Arquivo > Gerenciar conexões > Links Alteryx . Selecione o nome da fonte de dados na coluna "Nome" para exibir os detalhes da conexão, editá-la ou excluí-la.
Visualizar, editar e sincronizar links Alteryx existentes
Para visualizar os links Alteryx existentes, no Designer...
Vá para Arquivo > Gerenciar conexões > Links Alteryx .
Selecione o nome do link existente para abrir e visualizar os detalhes.
Para atualizar o link, clique no botão Editar . Faça as edições necessárias e clique em Salvar , ou em Cancelar para retornar à tela anterior.
Na seção Conexões , você também pode clicar em Sincronizar para sincronizar suas credenciais entre o Designer Desktop e o AACP.
Excluir link Alteryx
Para excluir um link Alteryx existente, no Designer Desktop...
Vá para Arquivo > Gerenciar conexões > Links Alteryx .
Selecione o ícone de lixeira associado ao link Alteryx que você deseja excluir. Isso faz com que a caixa de diálogo "Excluir" seja exibida. Clique no botão Excluir * para confirmar a exclusão, ou em "Cancelar" para retornar à tela anterior.
*A exclusão é permanente. Essa ação não pode ser desfeita.
Sincronizar credenciais
Com o DCM, você pode sincronizar suas credenciais por todo o pacote de produtos Alteryx.
Sincronizar credenciais entre o Designer e o Server
Acesse Arquivo > Gerenciar conexões para abrir o Gerenciador de Conexões.
Clique em Sincronizar .
Para uma nova conexão do Server...
Clique em + Novo .
Digite o URL da instância do Server e selecione Conectar .
Insira o E-mail e a Senha e selecione Entrar .
Selecione a instância do Server para sincronização.
Clique em Sincronizar .
Clique em Concluído .
Adicionar credenciais com sincronização
Acesse Arquivo > Gerenciar conexões para abrir o Gerenciador de Conexões.
Acesse Credenciais .
Selecione Adicionar credencial .
Digite os detalhes da credencial.
Clique em Salvar .
Execute as etapas de 2 a 5 da seção Sincronizar credenciais entre o Designer e o Server .
Editar credenciais com sincronização
Acesse Arquivo > Gerenciar conexões para abrir o Gerenciador de Conexões.
Acesse Credenciais .
Selecione a credencial para atualização.
Clique em Editar .
Atualize os detalhes da credencial.
Clique em Salvar .
Execute as etapas de 2 a 5 da seção Sincronizar credenciais entre o Designer e o Server .
Excluir credenciais com sincronização
Acesse Arquivo > Gerenciar conexões para abrir o Gerenciador de Conexões.
Acesse Credenciais .
Selecione a credencial que deseja excluir.
Selecione o ícone de lixeira .
Clique em Excluir para confirmar.
Execute as etapas de 2 a 5 da seção Sincronizar credenciais entre o Designer e o Server .
Sincronizar fluxo de trabalho com credenciais do DCM
Faça upload/download do fluxo de trabalho conforme as instruções do artigo Fluxos de trabalho .
Execute as etapas de 2 a 5 da seção Sincronizar credenciais entre o Designer e o Server .
Manage Proxy Servers
The Proxy Servers section allows you to configure proxy connections and credentials for use with Designer's new Proxy Settings*. This includes the authentication type (Basic, NTLM, Windows Negotiate) and credentials needed to connect through your proxy server.
2024.2 Proxy Updates: Public Preview
The 2024.2 updates to the proxy configuration are in Public Preview and specific to Alteryx Designer only. The proxy settings in Designer and DCM are not synced with Server. For additional important information, go to Proxy Settings
You need to create a connection and associated credentials for all proxy types (Use Internet Options Settings, Consume PAC file at this location, and Manual). Additionally, if you are using the Manual proxy configuration option (in Designer's User Settings), the connection must specify the host name/address of your proxy server, as well as associated credentials, if required. This is done via DCM.
To get started, in the Proxy Servers section of DCM, select the + New button.
Select the Proxy Server Technology via the Technology dropdown. Your options are…
Any Proxy Type: If you select this option, the proxy type is taken from the PAC file/Internet Options. Always use this option unless you select the Manual proxy or want to fine-tune your proxy settings for different proxy types.
HTTP Proxy
HTTPS Proxy
SOCKS5h Proxy
Enter a name for this Data Source in the Data Source Name field. This label will be used to reference this proxy server later in DCM and the Proxy User Settings, so it’s important to provide a descriptive name that will help you identify this connection later.
Enter the Proxy Server address via the Address field. This is required when using the Manual option of the Proxy Selection above. Otherwise, the proxy server address is provided by the PAC file/Internet Options settings. In that case, this field is optional and is used to match DCM proxy connections to the selected proxy server URL.
Example proxy host name address:
myproxy.example.com:1234
Example proxy IP address:
158.42.13.3:1234
(Optional) Select the request protocol for your Proxy Server via the Request protocol field. Use this option if you only want to use this connection for a specific protocol, for example, FTP. Your options are...
FTP
HTTP
HTTPS
SFTP
SMTP
Select Save.
Next, you have the option to create the credentials to authenticate to your proxy server.
Select + Connect Credential to get started.
Select your authentication method via the Authentication Method dropdown. Currently, username and password are the only supported credential types for all of these methods. To do Windows Integrated authentication, select the authentication method and leave the Credential information blank in DCM. These are the authentication methods that are currently supported:
Basic
No Authentication
NTLM
Windows Negotiate (SPNEGO/Kerberos)
Next, use the Credential dropdown to select Create New Credential. You can also select an existing credential (if previously created).
Enter a Credential Name. Once again, this is a label for you to reference later if needed.
Vault: If no vault connection exists beyond the local DCM storage, the Vault dropdown is not displayed. If a vault connection is established, the dropdown is available, with DCM local storage preselected. If configured, you can then choose your preferred vault, for example, HashiCorp or CyberArk and select the username and password from the vault. For more information, go to DCM External Vaults. Note that your vault itself has to be reachable without the use of a proxy.
Enter the Username and Password associated with the new credential to authenticate to your proxy server.
Select the Create and Link button to finish.
Edit Proxy Connection and Credentials
After you create your proxy connection and associated credentials, you can edit these details if needed. You can do this via DCM.
Edit Proxy Connection
To edit your proxy connection…
In Designer, go to File > Manage Connections to open DCM.
Select the Proxy Servers tab on the left to access all of the proxy connections that you have created.
Locate the connection you need to edit and select its name to view the connection details. Here you can view the information that was provided when the connection was created, as well as any linked credentials. You also have the option to Connect Credential if you have the need to.
Select the Edit button to make changes to the connection. Update the Data Source Name, Address, and Request protocol, as needed.
Select Save to finalize your changes or Cancel to return to the previous screen.
Edit Proxy Credentials
To edit your proxy credentials…
In Designer, go to File > Manage Connections to open DCM.
Select the Credentials tab on the left of the Connection Manager window to access all of your previously created credentials. This includes all credentials, not only ones associated with proxy connections.
Locate the credentials that you need to edit and select the credential name to view its details. Here, you can view the information that was provided when the credentials were created, as well as any connections that currently use the credentials.
Select the Edit button to update the credentials. Update the Method, Credential Name, Username, and Password as needed.
Select Save to finalize your changes or Cancel to return to the previous screen.
Backup e restauração
Você pode fazer backup do armazenamento do DCM e restaurá-lo a partir do arquivo de backup.
Importante
Esse recurso é baseado em seu licenciamento do Designer. Embora a restauração funcione entre duas licenças diferentes adquiridas dentro da mesma empresa, nesse caso, o backup e restauração sob duas licenças diferentes dentro da mesma empresa também devem estar em instâncias diferentes do Designer para funcionar. O backup e a restauração não funcionam em uma versão de avaliação ou com múltiplas licenças ativas em uma única instância do Designer.
Backup
Acesse Arquivo > Gerenciar conexões para abrir o Gerenciador de Conexões.
Selecione Backup .
Digite a senha do arquivo de backup.
Selecione o Backup .
Escolha um local e, opcionalmente, um nome para seu arquivo de backup.
Clique em Salvar .
Restaurar
Acesse Arquivo > Gerenciar conexões para abrir o Gerenciador de Conexões.
Selecione Restaurar .
Digite a senha do arquivo de backup.
Selecione Restaurar .
Nota
Observe que o backup só pode ser restaurado na mesma máquina em que foi criado. A maneira mais fácil de restaurar as conexões do DCM para um novo computador é sincronizá-las com o Alteryx Server ( Arquivo > Gerenciar conexões > Sincronizar > SERVER > Sincronizar ).
Sincronizar o DCM entre o Server e o Designer
Existem três definições de sincronização disponíveis:
No Synchronization (sem sincronização) – a sincronização de conexões do DCM fica bloqueada em ambos os sentidos.
One-way to Designer (unidirecional para o Designer) – a sincronização de conexões do DCM é habilitada apenas do Server para o Designer.
Full Synchronization (sincronização completa) – a sincronização de conexões do DCM é habilitada do Server para o Designer e do Designer para o Server.
Para sincronizar o DCM entre o Server e o Designer, siga estas etapas:
Acesse o Designer > Arquivo > Gerenciar conexões para abrir o Gerenciador de Conexões . Selecione Sincronizar no menu.
Selecione na lista o Server que você deseja sincronizar.
Clique em Sincronizar .
Depois de sincronizar o DCM entre o Server e o Designer, todas as credenciais que você possui e todas as fontes de dados às quais você tem acesso estarão visíveis e prontas para uso no Gerenciador de Conexões.
Conectores e ferramentas com suporte
Para obter a lista de ferramentas e conectores com suporte pelo DCM, acesse Conectores e ferramentas com suporte pelo DCM .