Detalhes da Conexão do Microsoft Office 365¶

Introdução¶

Versão do conector

Esta documentação é baseada na versão 21.0.8257 do conector.

Começando¶

Suporte para versões do Office 365

Todas as versões hospedadas do Office 365 são suportadas por meio do Microsoft Graph API v1.0. Inclui informações acessíveis de 365 edições do Exchange/Outlook, Teams, Tasks e OneDrive.

Estabelecendo uma Conexão¶

Conectando-se ao Microsoft Office 365¶

Autenticação Usando a Entidade de Serviço do Azure¶

A Entidade de Serviço do Azure é um tipo de conexão que passa por OAuth. Defina seu AuthScheme para AzureServicePrincipal e consulte Usando a Autenticação Principal de Serviço do Azure para obter um guia de autenticação.

Usando Autenticação OAuth¶

OAuth requer que o usuário autenticado interaja com o Office 365 usando o navegador. O conector facilita isso de várias maneiras, conforme descrito abaixo.

Credenciais Incorporadas¶

Consulte Credenciais incorporadas para se conectar com as credenciais incorporadas do conector e pule a criação de um aplicativo OAuth personalizado.

Credenciais Personalizadas¶

Em vez de se conectar com as credenciais incorporadas do conector, você pode registrar um aplicativo com Custom Credentials para obter o OAuthClientId e OAuthClientSecret.

Quando Criar um Aplicativo OAuth Personalizado¶

A criação de um aplicativo OAuth personalizado é opcional, pois o conector já está registrado no Office 365 e você pode se conectar com suas credenciais incorporadas. Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem logon no endpoint OAuth do Office 365 para conceder permissões ao conector.

Criando um Aplicativo OAuth Personalizado¶

Consulte Criando um aplicativo OAuth personalizado para um procedimento.

Credenciais Incorporadas¶

Autenticar Usando as Credenciais OAuth Incorporadas¶

Autenticação de Desktop com o Aplicativo OAuth Integrado¶

Você pode se conectar sem definir nenhuma propriedade de conexão para suas credenciais de usuário.

Quando você se conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth.

1. Extrai o token de acesso do URL de retorno de chamada e autentica as solicitações.
2. Obtém um novo token de acesso quando o antigo expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Credenciais Personalizadas¶

Existem dois tipos de autenticação de aplicativo disponíveis: usando um segredo do cliente e usando um certificado. Você pode usar qualquer um deles dependendo da autenticação de aplicativo configurada.

Autenticação de Área de Trabalho com Seu Aplicativo OAuth¶

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado.

Obtenha um Token de Acesso OAuth¶

Você está pronto para se conectar após definir um dos grupos de propriedades de conexão abaixo, dependendo do tipo de autenticação.

1. Authenticating using a Client Secret
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
   • CallbackURL: Defina isso para o URL de redirecionamento nas configurações do aplicativo.
   • AuthScheme: Defina isso como "AzureAD" nas configurações do aplicativo.
   • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken..
2. Authenticating using a Certificate
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthJWTCert: Defina isso para o armazenamento de certificados JWT.
   • OAuthJWTCertType: Defina isso para o tipo de armazenamento de certificado especificado por OAuthJWTCert.
   • CallbackURL: Defina isso para o URL de redirecionamento nas configurações do aplicativo.
   • AuthScheme: Defina isso como "AzureAD" nas configurações do aplicativo.
   • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken..

Quando você conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth:

1. Extrai o token de acesso do URL de retorno de chamada e autentica as solicitações.
2. Obtém um novo token de acesso quando o antigo expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Máquinas Sem Cabeça¶

Usando OAuth em uma Máquina Sem Cabeça¶

Para criar fontes de dados do Office 365 em servidores headless ou outras máquinas nas quais o conector não pode abrir um navegador, você precisa autenticar de outra máquina. A autenticação é um processo de duas etapas.

1. Ao invés de instalar o conector em outra máquina, você pode seguir os passos abaixo para obter o OAuthVerifier valor. Ou você pode instalar o conector em outra máquina e transferir os valores de autenticação OAuth, depois de autenticar por meio do fluxo normal baseado em navegador.
2. Em seguida, você pode configurar o conector para atualizar automaticamente o token de acesso da máquina sem periféricos.

Você pode seguir o fluxo de autenticação OAuth headless usando as credenciais OAuth incorporadas do conector ou usando as credenciais OAuth para seu aplicativo OAuth personalizado.

Usando as Credenciais para um Aplicativo OAuth Personalizado¶

Crie um aplicativo OAuth personalizado

Consulte Criando um aplicativo OAuth personalizado para um procedimento. Você pode seguir os procedimentos abaixo para autenticar e conectar-se aos dados.

Obtenha um código verificador

Na máquina sem periféricos, defina um dos seguintes grupos de propriedades, dependendo do tipo de autenticação:

1. Authenticating using a Client Secret
   • InitiateOAuth: Defina como DESLIGADO.
   • OAuthClientId: Defina isso como o ID do aplicativo nas configurações do aplicativo.
   • OAuthClientSecret: Defina isso como o Segredo do aplicativo nas configurações do aplicativo.
2. Authenticating using a Certificate
   • InitiateOAuth: Defina como DESLIGADO.
   • OAuthClientId: Defina isso como o ID do aplicativo nas configurações do aplicativo.
   • OAuthJWTCert: Defina isso para o armazenamento de certificados JWT.
   • OAuthJWTCertType: Defina isso para o tipo de armazenamento de certificado especificado por OAuthJWTCert.

Você pode seguir as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade de conexão.

1. Chame o GetOAuthAuthorizationURL procedimento armazenado* com o parâmetro de entrada CallbackURL definido para o URI de redirecionamento exato que você especificou nas configurações do aplicativo.
2. Abra o URL retornado em um navegador. Faça login e conceda permissões ao conector. Você será redirecionado para a URL de retorno de chamada. A página da Web indicará que o site não pôde ser acessado.
3. Inspecione o URL da página deste site e encontre o code valor. Ele estará presente na URL no formato code=XXXXXX (terminado com &, que denota o próximo parâmetro da URL ) O valor após o "code=" é o código do verificador.
4. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina um dos seguintes grupos de propriedades de conexão dependendo do tipo de autenticação para obter os valores de autenticação OAuth:

• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthVerifier: Defina isso para o código do verificador.
• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.
• InitiateOAuth: Configure para ATUALIZAR.

Conecte-se aos dados

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

• OAuthSettingsLocation: Defina isso para o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao provedor para ativar a atualização automática do token de acesso.
• InitiateOAuth: Configure para ATUALIZAR.

Configurações de transferência OAuth

Siga as etapas abaixo para instalar o conector em outra máquina, autenticar e depois transferir os valores OAuth resultantes.

Em uma segunda máquina, instale o conector e conecte-se a um dos seguintes grupos de propriedades, dependendo do tipo de autenticação:

1. Authenticating using a Client Secret
   • OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
   • InitiateOAuth: Defina como GETANDREFRESH.
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
   • CallbackURL: Defina isso para o URL de retorno de chamada nas configurações do aplicativo.
2. Authenticating using a Certificate
   • OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
   • InitiateOAuth: Defina como GETANDREFRESH.
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthJWTCert: Defina isso para o armazenamento de certificados JWT.
   • OAuthJWTCertType: Defina isso para o tipo de armazenamento de certificado especificado por OAuthJWTCert.
   • CallbackURL: Defina isso para o URL de retorno de chamada nas configurações do aplicativo.

Teste a conexão para autenticar. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:

• InitiateOAuth: Configure para ATUALIZAR.
• OAuthSettingsLocation: Defina isso como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.

Criando um Aplicativo OAuth Personalizado¶

Quando Criar um Aplicativo OAuth Personalizado¶

A criação de um aplicativo OAuth personalizado é opcional, pois o conector já está registrado no Office 365 e você pode se conectar com suas credenciais incorporadas.

Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem logon no endpoint OAuth do Office 365 para conceder permissões ao conector.

Siga as etapas abaixo para criar um aplicativo OAuth personalizado e obter as propriedades de conexão em um fluxo de autenticação OAuth específico.

Etapas para Criar um Aplicativo OAuth Personalizado¶

Siga as etapas abaixo para obter os valores OAuth para seu aplicativo, o OAuthClientId e OAuthClientSecret.

1. Faça login em https://portal.azure.com.
2. No painel de navegação à esquerda, selecione Azure Active Directory, em seguida, Registros de aplicativos e clique no botão Novo registro.
3. Insira um nome de aplicativo e defina o botão de opção para a configuração de locatário desejada. Ao criar um aplicativo OAuth personalizado no Azure Active Directory, você pode definir se o aplicativo é único ou multilocatário. Se você selecionar a opção padrão "Somente contas neste diretório organizacional", precisará definir o AzureTenant propriedade de conexão para a ID do locatário do Azure AD ao estabelecer uma conexão com o conector Jitterbit para Office 365. Caso contrário, a tentativa de autenticação falhará com um erro. Se seu aplicativo for apenas para uso privado, "Somente contas neste diretório da organização" deve ser suficiente. Caso contrário, se você quiser distribuir seu aplicativo, escolha uma das opções multilocatário.
4. Em seguida, defina o URL de redirecionamento para algo como http://localhost:33333, o padrão do conector. Ou defina uma porta diferente de sua escolha e defina CallbackURL para o URL de resposta exato que você definiu.
5. Defina o tipo de autenticação do aplicativo na seção Certificados e segredos. Existem dois tipos de autenticação disponíveis: usando um segredo do cliente e usando um certificado. O método de autenticação recomendado é por meio de um certificado, mas você também pode criar um segredo de aplicativo.
   • Option 1 - Upload a certificate: Na seção Certificados e Segredos, selecione Carregar certificado e selecione o certificado para carregar de sua máquina local.
   • Option 2 - Create a new application secret: Na seção Certificates & Secrets, selecione New Client Secret para o aplicativo e selecione sua duração. Depois de salvar o segredo do cliente, o valor da chave é exibido. Copie este valor, pois ele é exibido apenas uma vez e é usado como OAuthClientSecret.
6. Selecione Permissões de API e clique em Adicionar. Se você planeja que seu aplicativo se conecte sem um contexto de usuário, selecione as Permissões do aplicativo (OAuthGrantType = CLIENTE). Caso contrário, ao selecionar permissões, use as permissões delegadas.
7. Selecione a API do Microsoft Graph e selecione as permissões que seu aplicativo buscará.
8. Salve suas alterações.
9. Se você optou por usar permissões que exigem consentimento do administrador (como as Permissões do aplicativo), você pode concedê-las do locatário atual na página Permissões da API. Caso contrário, siga as etapas em Consentimento do administrador.

Consentimento do Administrador¶

O consentimento do administrador refere-se a quando o administrador de um locatário do Azure Active Directory concede permissões a um aplicativo que exige que um administrador consinta com o caso de uso. O aplicativo inserido no Conector Jitterbit para Office 365 não contém permissões que exijam o consentimento do administrador. Portanto, essas informações se aplicam apenas a aplicativos personalizados.

Permissões de Consentimento do Administrador¶

Ao criar um novo aplicativo OAuth no Portal do Azure, você deve especificar quais permissões o aplicativo exigirá. Algumas permissões podem ser marcadas informando "Consentimento do administrador necessário". Por exemplo, todas as permissões de grupos exigem consentimento do administrador. Se seu aplicativo exigir consentimento do administrador, há algumas maneiras de fazer isso.

A maneira mais fácil de conceder consentimento de administrador é apenas fazer com que um administrador faça logon em portal.azure.com e navegue até o aplicativo que você criou em Registros de aplicativos. Em Permissões da API, haverá um botão para Conceder consentimento. Você pode consentir aqui para que seu aplicativo tenha permissões no locatário sob o qual foi criado.

Se sua organização tiver vários locatários ou o aplicativo precisar receber permissões para outros locatários fora de sua organização, o GetAdminConsentURL pode ser usado para gerar o URL de autorização do administrador. Ao contrário do GetOAuthAuthorizationURL, não haverá nenhuma informação importante retornada desse endpoint. Se conceder acesso, ele simplesmente retornará um booleano indicando que as permissões foram concedidas.

Depois que um administrador concede o consentimento, a autenticação pode ser realizada normalmente.

Credenciais do Cliente¶

As credenciais do cliente referem-se a um fluxo no OAuth em que não ocorre nenhuma autenticação direta do usuário. Em vez disso, as credenciais são criadas apenas para o próprio aplicativo. Todas as tarefas executadas pelo aplicativo são realizadas sem um contexto de usuário padrão. Isso torna o fluxo de autenticação um pouco diferente do padrão.

Fluxo OAuth do Cliente¶

Todas as permissões relacionadas ao fluxo oauth do cliente exigem o consentimento do administrador. Isso significa que o aplicativo inserido com o Jitterbit Connector for Office 365 não pode ser usado no fluxo de oauth do cliente. Você deve criar seu próprio aplicativo OAuth para usar as credenciais do cliente. Consulte Criando um aplicativo OAuth personalizado para mais detalhes.

Em seu registro de aplicativo em portal.azure.com, navegue até API Permissions e selecione as permissões do Microsoft Graph. Existem dois conjuntos distintos de permissões - Permissões delegadas e de aplicativos. As permissões usadas durante a autenticação da credencial do cliente estão em Permissões do aplicativo. Selecione as permissões aplicáveis necessárias para sua integração.

Você está pronto para se conectar após definir um dos grupos de propriedades de conexão abaixo, dependendo do tipo de autenticação.

1. Authenticating using a Client Secret
   • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
   • AzureTenant: Defina isso para o inquilino ao qual você deseja se conectar.
   • OAuthGrantType: Defina como CLIENTE.
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
2. Authenticating using a Certificate
   • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
   • AzureTenant: Defina isso para o inquilino ao qual você deseja se conectar.
   • OAuthGrantType: Defina como CLIENTE.
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthJWTCert: Defina isso para o armazenamento de certificados JWT.
   • OAuthJWTCertType: Defina isso para o tipo de armazenamento de certificado especificado por OAuthJWTCert.

A autenticação com as credenciais do cliente ocorrerá automaticamente como qualquer outra conexão, exceto que não haverá nenhuma janela aberta solicitando ao usuário. Como não há contexto do usuário, não há necessidade de um pop-up do navegador. As conexões ocorrerão e serão tratadas internamente.

Usando a Autenticação Principal de Serviço do Azure¶

A autenticação como Entidade de Serviço do Azure é tratada por meio do fluxo de Credenciais do Cliente OAuth e não envolve autenticação direta do usuário. Em vez disso, as credenciais são criadas apenas para o próprio aplicativo. Todas as tarefas executadas pelo aplicativo são feitas sem um contexto de usuário padrão, mas com base nas funções atribuídas. O acesso do aplicativo aos recursos é controlado por meio das permissões das funções atribuídas.

Credenciais Personalizadas¶

Você precisará registrar um aplicativo OAuth para obter os valores da propriedade OAuth antes da conexão com a fonte de dados do Office 365. Você pode verificar as Credenciais personalizadas guia sobre como definir as propriedades OAuth.

Criando um Aplicativo OAuth Personalizado¶

Consulte Criando um aplicativo OAuth personalizado para um procedimento.

Criando um Aplicativo OAuth Personalizado¶

A criação de um aplicativo OAuth personalizado e uma entidade de serviço que pode acessar os recursos necessários é necessária ao autenticar usando uma entidade de serviço do Azure.

Siga as etapas abaixo para criar um aplicativo OAuth personalizado e obter as propriedades de conexão para a autenticação da Entidade de Serviço do Azure.

Etapas para Criar um Aplicativo OAuth Personalizado¶

Siga as etapas abaixo para obter os valores OAuth para seu aplicativo.

1. Faça login em <https://portal.azure.com>.
2. No painel de navegação à esquerda, selecione Azure Active Directory, em seguida, Registros de aplicativos e clique no botão Novo registro.
3. Insira um nome de aplicativo e defina o botão de opção para "Qualquer diretório do Azure AD - multilocatário". Em seguida, defina o URL de redirecionamento para algo como http://localhost:33333, o padrão do conector.
4. Copie o valor do ID do aplicativo (cliente) exibido na seção Visão geral após criar o aplicativo, pois esse valor é usado como OAuthClientId
5. Defina o tipo de autenticação do aplicativo na seção Certificados e segredos. Existem dois tipos de autenticação disponíveis: usando um segredo do cliente e usando um certificado. O método de autenticação recomendado é por meio de um certificado, mas você também pode criar um segredo de aplicativo.
   • Option 1 - Upload a certificate: Na seção Certificados e Segredos, selecione Carregar certificado e selecione o certificado para carregar de sua máquina local.
   • Option 2 - Create a new application secret: Na seção Certificates & Secrets, selecione New Client Secret para o aplicativo e selecione sua duração. Depois de salvar o segredo do cliente, o valor da chave é exibido. Copie este valor, pois ele é exibido apenas uma vez e é usado como OAuthClientSecret.
6. Na aba Autenticação, certifique-se de marcar a opção: Tokens de acesso (usados para fluxos implícitos).
7. Abra a página Assinaturas pesquisando e selecionando o serviço Assinaturas na barra de pesquisa.
8. Selecione a assinatura específica à qual atribuir o aplicativo, abra a seção Controle de acesso (IAM) e clique no botão Adicionar atribuição de papel.
9. Selecione Proprietário como a papel a ser atribuída ao aplicativo OAuth criado.

Credenciais Personalizadas¶

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado.

Autenticação com Seu Aplicativo OAuth¶

Atualmente, apenas o uso de um segredo do cliente tem suporte para autenticação.

Obtenha um Token de Acesso OAuth¶

Você está pronto para se conectar depois de definir as seguintes propriedades de conexão:

• Authenticating using a Client Secret
  • AuthScheme: Defina isso como "AzureServicePrincipal" nas configurações do aplicativo.
  • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
  • AzureTenant: Defina isso para o inquilino ao qual você deseja se conectar.
  • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
  • OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.

Tarefas Administrativas¶

O Conector Jitterbit para Office 365 pode ser usado para executar tarefas administrativas. Isso pode ser feito especificando a coluna UserId para executar operações CUD.

A Coluna UserId¶

Muitas tabelas expõem uma coluna UserId especial. Isso é projetado para ser usado por um administrador para modificar registros na conta de outro usuário. Se você não for um administrador ou não desejar esse comportamento, não especifique o UserId ao executar uma operação INSERT/UPDATE/DELETE. Por exemplo, executar o seguinte irá inserir um contato para outro usuário:

INSERT INTO Contacts (displayName, CompanyName, UserId) VALUES ('Bill', 'Bob Co', '12345')

A solicitação acima terá o efeito geral de tentar adicionar um contato no recurso em /users/12345/contacts. Quando UserId não for especificado, os recursos afetados serão modificados em /users/me/contacts. Em geral, se você não for um administrador, poderá apenas afetar ou visualizar registros em /users/me, portanto, não é recomendável definir UserId quando você não for um administrador.

Anotações Importantes¶

Procedimentos Armazenados¶

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos¶

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas¶

Esta seção detalha uma seleção de recursos avançados do conector do Office 365.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visualizações definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário¶

O Jitterbit Connector for Office 365 permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma exibição.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a visualização.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Events WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Exibições Definidas pelo Usuário¶

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário¶

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resultando na consultar efetiva à fonte:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões bem mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL¶

Personalizando a Configuração SSL¶

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados¶

O conector modela a API do Office 365 como tabelas relacionais. Quaisquer alterações nos dados remotos são refletidas imediatamente em suas consultas; as definições da tabela são recuperadas dinamicamente. Quando você se conecta, o conector se conecta ao Office 365 e obtém a lista de tabelas e os metadados das tabelas chamando os serviços Web apropriados.

As limitações e requisitos da API estão documentados nesta seção; você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Mesas

Tabelas mostra as definições de um site de exemplo do Office 365. O modelo de dados real será obtido dinamicamente com base em suas credenciais de usuário e no site do Office 365.

Procedimentos armazenados

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para o Office365. Eles podem ser usados para pesquisar, atualizar e modificar informações no Office365.

Tabelas¶

O conector modela os dados no Office 365 em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do Office 365 é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Tabelas do Office 365¶

Calendários¶

Esta tabela é dinâmica e mapeia para o campo correspondente na API.

Informações Específicas da Tabela¶

Selecione¶

Você pode consultar calendários especificando um ID ou selecionando todos:

SELECT * FROM Calendars WHERE ID = 'your Calendar ID goes here'

Selecione uma determinada coluna da entidade e filtre por essa coluna:

SELECT ID FROM Calendars WHERE name LIKE 'Calendar%'

Inserir¶

Especifique um nome no mínimo para criar um novo calendário:

INSERT INTO Calendars (Name) VALUES ('John')

Observação: No caso de credenciais de cliente, o UserId é necessário para criar um novo calendário:

INSERT INTO Calendars(Name, UserId)values('Test123', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe');

Colunas¶

Contatos¶

A tabela de contatos do Office365.

Informações Específicas da Tabela¶

Selecione¶

Você pode consultar Contatos especificando um ID ou selecionando todos:

SELECT * FROM Contacts WHERE ID = 'your Contact ID goes here'

Selecione uma determinada coluna da entidade e filtre por essa coluna:

SELECT GivenName FROM Contacts WHERE GivenName LIKE 'John%'

Inserir¶

Especifique um GivenName e um Sobrenome no mínimo para criar um novo contato:

INSERT INTO Contacts (GivenName, Surname) VALUES ('John', 'Smith')

Observação: No caso de credenciais de cliente, o UserId é necessário para criar um novo contato:

INSERT INTO Contacts (GivenName, Surname, UserId) VALUES ('John', 'Smith', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe')

Colunas¶

Conversas¶

A tabela Conversas do Office365.

Informações Específicas da Tabela¶

Selecione¶

O GroupId é necessário para obter conversas em grupo.

SELECT * FROM Conversations WHERE GroupId = 'your GroupId goes here'

Você também pode obter conversas em grupo usando o GroupId e o ID da conversa.

SELECT * FROM Conversations WHERE ID = 'conversation ID here' AND GroupId = 'your GroupId goes here'

Inserir¶

Especifique GroupId, Topic, Content e NewParticipants para criar uma nova conversa. NewParticipants é um tipo complexo. Seu formato é o seguinte: 'name1, email1; nome2, e-mail2'.

INSERT INTO Conversations (GroupId, Topic, Content, NewParticipants) VALUES ('GroupId here', 'This is a test topic.', 'Hi, How Are you?', 'someone, someone@example.com')

Colunas¶

Eventos¶

Este campo é dinâmico e mapeia para o campo correspondente na API.

Informações Específicas da Tabela¶

Selecione¶

A propriedade 'me' é usada por padrão para retornar eventos.

Você pode usar o UserId na cláusula WHERE para substituir isso ao procurar eventos.

SELECT * FROM Events WHERE UserId = 'abc123' AND Subject LIKE '%test%'

O GroupId pode ser um ID de tipo de calendário ou um ID de grupo. Por exemplo:

SELECT * FROM Events WHERE GroupId = 'enter your group ID here'

Inserir¶

Para criar um novo evento, são necessários início e fim, incluindo o fuso horário.

INSERT INTO Events (Subject, Body_Content, Start_DateTime, Start_TimeZone, End_DateTime, End_TimeZone) VALUES ('New Test Event', 'Event created using Office365Provider', '2016-01-01T10:00:00', 'UTC', '2016-01-01T11:00:00', 'UTC')

Observação: Por padrão, esta instrução criará seu evento no calendário padrão.

Observação: No caso de credenciais de cliente, o UserId é necessário para criar um novo evento:

INSERT INTO Events (Subject, Body_Content, Start_DateTime, Start_TimeZone, End_DateTime, End_TimeZone, UserId) VALUES ('New Test Event', 'Event created using Office365Provider', '2016-01-01T10:00:00', 'UTC', '2016-01-01T11:00:00', 'UTC', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe')

Colunas¶

Arquivos¶

A tabela do Office365 Arquivos.

Informações Específicas da Tabela¶

Selecione¶

Recupere arquivos usando UserId ou File ID (Id), por exemplo, ou simplesmente filtre por uma determinada coluna:

SELECT * FROM Files WHERE UserId = 'MyUserId'

SELECT Name, LastModifiedDateTime FROM Files WHERE Name LIKE 'test%'

Para trabalhar com arquivos em nível de pasta, precisamos especificar o parentReference_path na consultar.

SELECT * FROM files WHERE parentReference_path = '/drives/b!3LIvU2zISEqicGlWkgVknKxKT-q7gM5IqlBJ4w4MZqaX6BQc_vtwQpnqaldXkH9I/root:/Test_Shubham';

Inserir¶

A operação de inserção não é suportada para esta tabela.

Observação: Consulte UploadArquivo (ou CriarPasta para criar uma pasta) para inserir e atualizar o conteúdo de um arquivo.

Colunas¶

Grupos¶

A tabela Grupos do Office365.

Informações Específicas da Tabela¶

Os grupos requerem permissões de administrador. Para trabalhar com eles, você deve criar seu próprio aplicativo OAuth personalizado e definir o apropriadoOAuthClientId e OAuthClientSecret. Neste aplicativo, você deve configurá-lo para solicitar as permissões Group.Read.All e Group.ReadWrite.All. Isso pode ser feito em https://apps.dev.microsoft.com, ou no painel Registros de aplicativos em http://portal.azure.com. Consulte Credenciais personalizadas para obter mais detalhes sobre como criar um aplicativo personalizado.

Para autorizar permissões de Grupos, um administrador deve conceder as permissões de Grupos para sua organização como um todo. Isso pode ser feito por meio do endpoint de autorização do administrador. Basta que o administrador navegue até a seguinte página da Web e conceda permissões. Em seguida, execute a autorização OAuth normalmente.

https://login.microsoftonline.com/common/adminconsent?client_id=[YourClientId]&redirect_uri=http://localhost:33333

Observe que, se sua organização tiver vários locatários, você poderá substituir /common/ na URL pela ID do locatário para indicar a qual locatário conceder permissões.

Selecione¶

Recupere todos os grupos, especifique um GroupId (Id) ou simplesmente filtre por uma determinada coluna:

SELECT * FROM Groups
SELECT * FROM Groups WHERE Id = 'Group Id here'
SELECT Id, Description, DisplayName FROM Groups WHERE Name = 'test'

Inserir¶

Os itens a seguir são necessários para criar um novo grupo de segurança:

INSERT INTO Groups (DisplayName, MailEnabled, MailNickname, SecurityEnabled) VALUES ('Test group', false, 'test', true)

Colunas¶

Mensagens¶

As mensagens da tabela Office365.

Informações Específicas da Tabela¶

Selecione¶

Você pode recuperar tudo de Mensagens, especificar uma Mensagem (Id), UserId ou ParentFolderId ou filtrar os resultados por uma determinada coluna:

SELECT * FROM Messages
SELECT * FROM Messages WHERE Id = 'MyMessageId'

SELECT * FROM Messages WHERE UserId = 'MyUserId'

SELECT * FROM Messages WHERE ParentFolderId = 'MyParentfolderId' 
SELECT * FROM Messages WHERE ParentFolderId = 'Drafts'
SELECT DisplayName, ID FROM Users WHERE DisplayName LIKE 'John%'

Inserir¶

Após a inserção uma nova Mensagem será criada na pasta Rascunhos do Usuário.

INSERT INTO Messages (Subject, Body_Content, UserId) VALUES ('New test Email', 'Test Email created.', 'User ID goes here')

Nota: Para enviar o e-mail, consulte SendMail.

Problemas Conhecidos¶

No momento, há um problema com esta tabela. Às vezes, pode retornar um número inconsistente de resultados. Ou seja, ele pode retornar um número X de linhas para alguma consultar e se você tentar essa consultar novamente logo após ela retornará um número diferente de linhas, mesmo que você não tenha alterado nada. Algumas linhas podem estar faltando.
Este é um problema de API conhecido que atualmente não tem solução alternativa. Assim que a Microsoft o corrigir em sua API do Microsoft Graph, ele também funcionará automaticamente neste conector.

Dito isso, existe uma configuração que você pode aplicar no conector para recuperar todas as mensagens, mas ela vem com uma desvantagem: os dados de 'eventos' e 'contatos' serão retornados junto com os dados de 'mensagens'. Portanto, não garantimos a pureza das informações. Você terá que confiar em sua própria filtragem para distinguir entre linhas de mensagens e não mensagens.

Para ativar a configuração basta adicionar "ClientSidePaging=true;" (sem aspas) no valor de Other propriedade de conexão.

Colunas¶

Planos¶

A tabela Planos do Office365.

Informações Específicas da Tabela¶

O uso de Planos requer acesso às permissões de Grupos. Isso requer aprovação do administrador. Por esse motivo, você deve usar seu próprio aplicativo OAuth para adicionar as permissões de grupos e do Microsoft Graph. Consulte Criando um aplicativo OAuth personalizado para mais detalhes.

Selecione¶

Todos os planos no MS Planner existem como parte de um grupo. Para recuperar a lista de planos disponíveis, você deve recuperar uma lista de planos disponíveis por grupo. Se nenhum GroupId for especificado, a seguinte condição WHERE será anexada a qualquer consultar:

GroupId IN (SELECT ID FROM Groups)

Colunas¶

Tarefas¶

As tarefas da tabela do Office365.

Informações Específicas da Tabela¶

Tarefas requer as permissões Grupos e Tarefas do Microsoft Graph. Por esse motivo, você deve criar seu próprio aplicativo OAuth. Consulte Criando um aplicativo OAuth personalizado para mais detalhes.

Selecione¶

Por padrão, se nenhum critério for especificado, apenas as Tarefas atribuídas pessoalmente a você serão exibidas. Por exemplo:

SELECT * FROM Tasks

Para trazer de volta tarefas em toda a organização, forneça os IDs de planos específicos ou use uma subseleção para o ID do plano. Por exemplo:

SELECT * FROM Tasks WHERE PlanId IN (SELECT ID FROM Plans)

Inserir¶

Para inserir uma Tarefa, o plano associado deve ser especificado:

INSERT INTO Tasks (Title, PlanId) VALUES ('My Title', '99999999-eeeeeeeee')

Atualizar¶

Para atualizar uma tarefa, o ID e a Etag devem ser especificados:

UPDATE Tasks SET Title='New Title' WHERE ID = 'xxxxxx-AAAAAAAAAAA' AND Etag='W/\"XXXXXXQEBAQEBAQEBAQEBAQEBARCc=\"'

Excluir¶

Para excluir uma tarefa, tanto o ID quanto a Etag devem ser especificados:

DELETE FROM Tasks WHERE ID = 'xxxxxx-AAAAAAAAAAA' AND Etag='W/\"XXXXXXQEBAQEBAQEBAQEBAQEBARCc=\"'

Colunas¶

Usuários¶

A tabela Usuários do Office365.

Informações Específicas da Tabela¶

Selecione¶

Consulte a tabela Users recuperando tudo de Users, especificando um ID ou filtrando por uma coluna:

SELECT * FROM Users WHERE Id = '616391f0-32d8-4127-8f25-aa55771d6617'

SELECT DisplayName, ID FROM Users WHERE DisplayName LIKE 'John%'

Inserir¶

O seguinte é necessário para criar um novo usuário organizacional:

INSERT INTO Users (AccountEnabled, DisplayName, MailNickname, UserPrincipalName, PasswordProfile_ForceChangePasswordNextSignIn, PasswordProfile_Password) VALUES (false, 'John Smith', 'JohnS', 'smithjohn@yourcompanydomain.com', true, '123password')

Colunas¶

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Exibições do Office 365¶

CalendarView¶

Recupere as ocorrências, exceções e instâncias únicas de eventos em uma exibição de calendário definida por um intervalo de tempo, do calendário padrão do usuário ou de algum outro calendário do usuário.

Informações Específicas da Tabela¶

Selecione¶

Obtenha as ocorrências, exceções e instâncias únicas de eventos em uma exibição de calendário definida por um intervalo de tempo, do calendário padrão do usuário ou de algum outro calendário do usuário. Por padrão, serão retornadas apenas as ocorrências de eventos do calendário padrão do usuário no intervalo dos últimos 30 dias. Você pode filtrar os resultados por CalendarId, UserId, Start_DateTime, End_DateTime.

Por exemplo, as seguintes consultas serão processadas no lado do servidor:

Select * FROM CalendarView Where Start_DateTime>='2019-12-10 15:00' AND End_DateTime<='2020-01-10 14:30'

SELECT * FROM CalendarView Where CalendarId='AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAwcAAABDJHYjDdygQ5pQPUEu3S2cAAACC_IAAAA='

SELECT * from CalendarView Where CalendarId='AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAwcAAABDJHYjDdygQ5pQPUEu3S2cAAACC_IAAAA=' And UserId='a98f25b5-5da1-4937-8729-c0d03026caa0' AND Start_DateTime>='2019-12-15 08:00' AND End_DateTime<='2020-01-14 08:00'

Colunas¶

Ocorrências de Eventos¶

Informações de uso para a operação EventOccurrences.rsd.

Informações Específicas da Tabela¶

Selecione¶

Você pode consultar EventOccurrences especificando a ID do evento, StartDatetime e EndDateTime. EventId é um campo obrigatório, em vez disso, StartDatetime e EndDateTime têm um intervalo padrão dos últimos 30 dias. Se você consultar a filtragem apenas por EventId e o evento específico não existir nesse intervalo de tempo, obterá resultados vazios.

SELECT * FROM [Ocorrências de eventos] WHERE id='event id' AND StartDateTime='2018/01/01' AND EndDateTime='2018/12/31'

Por padrão, se os filtros StartDateTime e EndDateTime não forem especificados, serão retornadas apenas as ocorrências de eventos do calendário padrão do usuário no intervalo dos últimos 30 dias. Caso contrário, a consultar obterá as Ocorrências do Evento durante o período especificado por StartDateTime e EndDateTime.

Colunas¶

Procedimentos Armazenados¶

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados do Office 365¶

Atribuir Licença¶

Adicione ou remova assinaturas para o usuário. Você também pode ativar e desativar planos específicos associados a uma assinatura

Entrada¶

Colunas do Conjunto de Resultados¶

CancelEvento¶

Cancela um evento.

Entrada¶

Colunas do Conjunto de Resultados¶

Criar Pasta¶

Carregue um novo arquivo ou atualize o conteúdo de um arquivo existente.

Entrada¶

Colunas do Conjunto de Resultados¶

Criar Esquema¶

Cria um arquivo de esquema para a tabela ou exibição especificada.

Entrada¶

Colunas do Conjunto de Resultados¶

DownloadAnexos¶

Baixar os anexos de um e-mail

Entrada¶

Colunas do Conjunto de Resultados¶

Baixar Email¶

Baixe o E-mail

Entrada¶

Colunas do Conjunto de Resultados¶

⇬ Fazer Download do Arquivo¶

Baixe o arquivo

Entrada¶

Colunas do Conjunto de Resultados¶

ForwardEvent¶

Encaminhar eventos para destinatários.

Entrada¶

Colunas do Conjunto de Resultados¶

ForwardMail¶

Recuperar e-mails encaminhados.

Entrada¶

Colunas do Conjunto de Resultados¶

GetAdminConsentURL¶

Obtém a URL de consentimento do administrador que deve ser aberta separadamente por um administrador de um determinado domínio para conceder acesso ao seu aplicativo. Necessário apenas ao usar credenciais OAuth personalizadas.

Entrada¶

Colunas do Conjunto de Resultados¶

GetOAuthAccessToken¶

Obtém um token de autenticação do Office365.

Entrada¶

Colunas do Conjunto de Resultados¶

GetOAuthAuthorizationURL¶

Obtém a URL de autorização que deve ser aberta separadamente pelo usuário para conceder acesso ao seu aplicativo. Necessário apenas ao desenvolver aplicativos da Web. Você solicitará o token de autenticação deste URL.

Entrada¶

Colunas do Conjunto de Resultados¶

MoveMail¶

Mover correio.

Entrada¶

Colunas do Conjunto de Resultados¶

RefreshOAuthAccessToken¶

Atualiza o token de acesso OAuth usado para autenticação com vários serviços do Office 365.

Entrada¶

Colunas do Conjunto de Resultados¶

Enviar Correio¶

Enviar correio.

Entrada¶

Subir Arquivo¶

Carregue um novo arquivo ou atualize o conteúdo de um arquivo existente.

Entrada¶

Colunas do Conjunto de Resultados¶

Tabelas do Sistema¶

Você pode consultar as tabelas do sistema descritas nesta seção para acessar informações de esquema, informações sobre a funcionalidade da fonte de dados e estatísticas de operação em lote.

Tabelas de Esquema¶

As tabelas a seguir retornam metadados de banco de dados para o Office 365:

• sys_catalogs: Lista os bancos de dados disponíveis.
• sys_schemas: Lista os esquemas disponíveis.
• sys_tables: Lista as tabelas e exibições disponíveis.
• sys_tablecolumns: Descreve as colunas das tabelas e exibições disponíveis.
• sys_procedures: Descreve os procedimentos armazenados disponíveis.
• sys_procedureparameters: Descreve procedimento armazenado* parâmetros.
• sys_keycolumns: Descreve as chaves primárias e estrangeiras.
• sys_indexes: Descreve os índices disponíveis.

Tabelas de Fonte de Dados¶

As tabelas a seguir retornam informações sobre como se conectar e consultar a fonte de dados:

• sys_connection_props: Retorna informações sobre as propriedades de conexão disponíveis.
• sys_sqlinfo: Descreve as consultas SELECT que o conector pode descarregar para a fonte de dados.

Consultar Tabelas de Informações¶

A tabela a seguir retorna estatísticas de consultar para consultas de modificação de dados:

• sys_identity: Retorna informações sobre operações em lote ou atualizações únicas.

Sys_catalogs¶

Lista os bancos de dados disponíveis.

A consultar a seguir recupera todos os bancos de dados determinados pela string de conexão:

SELECT * FROM sys_catalogs

Colunas¶

Sys_schemas¶

Lista os esquemas disponíveis.

A consultar a seguir recupera todos os esquemas disponíveis:

SELECT * FROM sys_schemas

Colunas¶

Sys_tables¶

Lista as tabelas disponíveis.

A consultar a seguir recupera as tabelas e exibições disponíveis:

SELECT * FROM sys_tables

Colunas¶

Sys_tablecolumns¶

Descreve as colunas das tabelas e exibições disponíveis.

A consultar a seguir retorna as colunas e os tipos de dados da tabela Eventos:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Events' 

Colunas¶

Sys_procedures¶

Lista os procedimentos armazenados disponíveis.

A consultar a seguir recupera os procedimentos armazenados disponíveis:

SELECT * FROM sys_procedures

Colunas¶

Sys_procedureparameters¶

Descreve procedimento armazenado* parâmetros.

A consultar a seguir retorna informações sobre todos os parâmetros de entrada para o procedimento armazenado SendMail:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SendMail' AND Direction=1 OR Direction=2

Colunas¶

Sys_keycolumns¶

Descreve as chaves primárias e estrangeiras. A consultar a seguir recupera a chave primária da tabela Eventos:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Events'

Colunas¶

Sys_foreignkeys¶

Descreve as chaves estrangeiras. A consultar a seguir recupera todas as chaves estrangeiras que se referem a outras tabelas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Colunas¶

Sys_indexes¶

Descreve os índices disponíveis. Ao filtrar por índices, você pode escrever consultas mais seletivas com tempos de resposta de consultar mais rápidos.

A consultar a seguir recupera todos os índices que não são chaves primárias:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Colunas¶