As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Conectar-se a uma fonte de dados Salesforce **nota** Essa fonte de dados é somente para o Grafana Enterprise. Para obter mais informações, consulte [Gerenciar o acesso aos plug-ins do Enterprise](upgrade-to-enterprise-plugins.md). Além disso, em espaços de trabalho compatíveis com a versão 9 ou mais recente, essa fonte de dados pode requerer a instalação do plug-in apropriado. Para obter mais informações, consulte [Ampliar o espaço de trabalho com plug-ins](grafana-plugins.md). A fonte de dados Salesforce permite que você visualize dados do Salesforce no Amazon Managed Grafana. Para usar essa fonte de dados, você deve ter uma conta do [Salesforce](https://www.salesforce.com/) e uma [aplicação conectada ao Salesforce](https://help.salesforce.com/articleView?id=sf.connected_app_overview.htm&type=5). ## Limitações conhecidas + Ad-hoc os filtros ainda não são suportados. + Atualmente, somente consultas SOQL e dados acessíveis via SOQL são compatíveis. Os formatos de consulta SOSL e SAQL ainda não são compatíveis. ## Configurações necessárias As configurações a seguir são necessárias. **nota** Atualmente, o plug-in usa o OAuth 2.0 Username-Password Flow. O URL de retorno de chamada necessário na aplicação conectada não é usado. Assim, você pode configurá-lo para qualquer URL válido. | Name (Nome) | Description | | --- | --- | | Enable OAuth settings | Você deve marcar esta opção para habilitar o OAuth. | | Callback URL | Não é usado neste plug-in, então você pode especificar qualquer URL válido. | | Selected OAuth Scopes (minimum requirements) | Acesse e gerencie os dados (api). | | Require Secret for Refresh Token Flow | Você pode habilitar ou desabilitar esta opção. | ## Adicionar a fonte de dados 1. Abra o console do Grafana no espaço de trabalho do Amazon Managed Grafana e verifique se está logado. 1. No menu lateral, em **Configuração** (o ícone de engrenagem), escolha **Fontes de dados**. 1. Escolha **Adicionar fonte de dados**. **nota** Se você não vir o link **Fontes de dados** no menu lateral, isso significa que seu usuário atual não tem o perfil de `Admin`. 1. Selecione **Salesforce** na lista de fontes de dados. 1. Insira as seguintes informações: + Em **Nome de usuário**, insira o nome de usuário da conta do Salesforce que você deseja usar para se conectar e consultar o Salesforce. + Em **Senha**, insira a senha do usuário. + Em **Token de segurança**, insira o token de segurança do usuário. + Em **Chave do consumidor**, insira a chave do consumidor A para se conectar ao Salesforce. Você pode obtê-la na aplicação conectada do Salesforce. + Em **Segredo do consumidor**, insira o segredo do consumidor A para se conectar ao Salesforce. Você pode obtê-la na aplicação conectada do Salesforce. + Em **Usar sandbox**, selecione esta opção se quiser usar um sandbox do Salesforce. ## Consultar a fonte de dados Salesforce O editor de consultas é compatível com os modos Query Builder e SOQL Editor. SOQL significa [Salesforce Object Query Language](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm). ### Query Builder (SOQL Builder) O Query Builder é uma interface amigável para criar consultas SOQL. Caso não esteja familiarizado com a criação de consultas SOQL, você poderá usar esse modo para criar o SOQL para consultar objetos do Salesforce. O campo **DE** no construtor de consultas refere-se à entidade ou às entidades no Salesforce. Você precisa selecionar o campo **DE** antes de qualquer outra operação no construtor de consultas. Depois de escolher o campo **DE**, você precisa escolher o modo do construtor. Atualmente, o SOQL Builder é compatível com os modos a seguir. + `List`— Listar os itens com seus campos a partir dos selecionados table/salesforce. Use este modo para obter resultados como “Mostre-me uma lista de oportunidades criadas neste trimestre fiscal junto com seu nome, valor e estágio”. + `Aggregate`: agrega os itens em uma entidade. Use este modo para obter resultados como “Conte as oportunidades criadas no mês passado.” ou “Qual é o valor total das oportunidades agrupadas pelo nome do estágio?”. + `Trend`: exibe os resultados agregados ao longo do tempo. Use esse modo para obter resultados como “Contar o número de oportunidades por” CreatedDate. ou “Qual é a soma total do valor agrupado pelas datas de encerramento das oportunidades?”. Depois de escolher `Entity/FROM` e o **modo** no editor de consultas, crie a consulta usando as opções a seguir. | **Campos** | **Aplicável a** | **Descrições** | | --- | --- | --- | | SELECT | ALL | Selecione a lista de campos que você deseja ver. Para a visualização agregada ou de tendência, selecione também como você deseja agregar os valores. | | WHERE | ALL | (Opcional) Especifique as condições do filtro. Os resultados são filtrados com base nas condições que você seleciona. | | ORDER BY | LIST, AGGREGATE | (Opcional) Selecione o nome do campo e a ordem de classificação que você deseja para os resultados. | | LIMIT | LIST, AGGREGATE | (Opcional) Limite o número de resultados retornados. O padrão é 100. | | GROUP BY | AGGREGATE | (Opcional) Selecione o campo se quiser dividir o valor agregado por qualquer campo específico. | | TIME FIELD | TREND | Especifique o campo de data pelo qual você deseja agrupar os resultados. Os resultados são filtrados com base no intervalo do seletor de tempo do Grafana. | Ao configurar os campos anteriores no editor de consultas, você também verá uma pré-visualização do SOQL gerado abaixo do editor de consultas. Caso esteja bloqueado por alguma limitação no construtor de consultas, você poderá alternar com segurança para o SOQL Editor, onde poderá personalizar a consulta SOQL gerada. ### Editor SOQL O editor SOQL bruto oferece a opção de consultar objetos do Salesforce por meio de uma consulta SOQL bruta. O editor SOQL fornece sugestões de preenchimento automático, como entidades disponíveis por tabelas e campos correspondentes. Use Ctrl\+Espaço depois de SELECT ou WHERE para ver as entidades disponíveis por tabelas. Você poderá ver os campos disponíveis ao inserir um ponto após o nome da entidade. **Atalhos** Use CTRL \+ SPACE para mostrar o preenchimento de código, que mostra as opções contextuais disponíveis. CMD \+ S executa a consulta. **Consultar como série temporal** Faça uma consulta de série temporal atribuindo um alias de um campo de data para tempo e de um campo de métrica para métrica e, em seguida, agrupando por métrica e data. Este é um exemplo: ``` SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity group by Type, CloseDate ``` **Macros** Para filtrar pelo intervalo de tempo do dashboard, você pode usar macros em suas consultas SOQL: + `$__timeFrom`: será substituído pelo início da seleção de tempo atualmente ativa convertida para o tipo de dados de `time`. + `$__timeTo`: será substituído pelo final da seleção de tempo atualmente ativa convertida para o tipo de dados de `time`. + `$__quarterStart`— O início do trimestre fiscal (derivado das configurações do ano SalesForce fiscal). + `$__quarterEnd`— O final do trimestre fiscal (derivado das configurações do ano SalesForce fiscal). ``` SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom ``` ## Modelos e variáveis Para adicionar uma nova variável de consulta do Salesforce, consulte [Adicionar uma variável de consulta.](variables-types.md#add-a-query-variable). Use a fonte de dados Salesforce como sua fonte de dados. Você pode usar qualquer consulta SOQL aqui. Se você quiser usar name/value pares, por exemplo, um ID de usuário e nome de usuário, retorne dois campos da sua consulta SOQL. O primeiro campo será usado como ID. Faça isso quando quiser filtrar por chave (ID, etc.) em seu editor de consultas SOQL. Use a variável nas consultas SOQL usando a sintaxe de variável. Para obter mais informações, consulte [Sintaxe da variável](templates-and-variables.md#variable-syntax).