Detalhes da Conexão do Bugzilla¶
Introdução¶
Versão do conector
Esta documentação é baseada na versão 21.0.8383 do conector.
Começando¶
Suporte à versão do Bugzilla
O conector aproveita a API do Bugzilla para habilitar o acesso bidirecional ao Bugzilla.
Estabelecendo uma Conexão¶
Conectando ao Bugzilla¶
Você pode usar a IU do desenvolvedor do Bugzilla para estabelecer uma conexão com sua instância do Bugzilla. Para obter detalhes sobre este processo, consulte Conectando-se ao Bugzilla.
Conectando ao Bugzilla¶
Esta seção documenta como fornecer autenticação para seu tipo de conta.
Autenticar uma Conta Bugzilla¶
Você pode se autenticar em sua conta Bugzilla usando estes dois parâmetros:
URL:
Este é o URL da página do desenvolvedor do Bugzilla (oHome
página).ApiKey:
Chaves de API podem ser geradas a partir doPreferences > API Keys
seção da página do desenvolvedor do Bugzilla.
Características Avançadas¶
Esta seção detalha uma seleção de recursos avançados do conector Bugzilla.
Visualizações definidas pelo usuário
O conector permite definir tabelas virtuais, denominadas visõ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 Bugzilla 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 visualização.
- Cada elemento raiz contém um elemento filho, chamado
query
, que contém a consultar SQL personalizada para a exibição.
Por exemplo:
{
"MyView": {
"query": "SELECT * FROM SampleTable_1 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 muito 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 Jitterbit Connector for Bugzilla modela objetos Bugzilla como tabelas relacionais e visualizações. Um objeto Bugzilla tem relacionamentos com outros objetos nas tabelas e esses relacionamentos são expressos por meio de chaves estrangeiras.
As seções a seguir mostram os objetos de API disponíveis e fornecem mais informações sobre como executar SQL para APIs do Bugzilla.
Os esquemas para a maioria dos objetos de banco de dados são definidos em arquivos de configuração simples baseados em texto.
O conector transfere o máximo possível do processamento da instrução SELECT para as APIs do Bugzilla e, em seguida, processa o restante da consultar na memória. Ver SupportEnhancedSQL
para obter mais informações sobre como o conector contorna as limitações da API com processamento na memória do lado do cliente.
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 Visualizações do Bugzilla¶
Nome | Descrição |
---|---|
Attachments | Obtenha dados sobre anexos, com uma lista de bugs e/ou IDs de anexos. Anexos privados só serão devolvidos se você estiver no grupo apropriado ou se for o remetente do anexo. |
BugCcDetail | Retorna detalhes do CC de um determinado Bug. A consultar 'SELECT * FROM BugCcDetail' pode ser lenta se você tiver muitos bugs. Nesse caso, use a filtragem 'IN' para melhor desempenho. |
BugFields | Obtenha informações sobre campos de bug válidos. |
BugHistory | Retorna informações sobre o histórico do bug que você especificou. A consultar 'SELECT * FROM BugHistory' pode ser lenta se você tiver muitos bugs. Nesse caso, use a filtragem 'IN' para melhor desempenho. |
Bugs | Obtenha informações sobre seus bugs. |
Comments | Permite que você obtenha dados sobre comentários, dado um ID de bug ou ID de comentário. |
CommentTags | Obtenha informações sobre as tags definidas atualmente para um comentário. |
ComponentFlagTypes | Obtenha informações sobre os tipos de sinalizadores de um componente. |
Flags | Obtenha informações sobre os sinalizadores de um anexo ou os sinalizadores de um bug. |
Groups | Retorna informações sobre os grupos do Bugzilla. |
ProductComponents | Obter informações sobre os componentes de um produto. Consultar 'SELECT * FROM ProductComponents' pode ser lento porque recupera todos os ProductIDs e faz chamadas separadas para cada um deles para obter os ProductComponents. Nesse caso, use a filtragem 'IN' para obter melhor desempenho. |
ProductMilestones | Obtenha informações sobre os marcos de um determinado produto. Consultar 'SELECT * FROM ProductMilestones' pode ser lento porque recupera todos os ProductIDs e, em seguida, faz chamadas separadas para cada um deles para obter os ProductMilestones. Nesse caso, use a filtragem 'IN' para obter melhor desempenho. |
Products | Liste os produtos disponíveis e obtenha informações sobre eles. Por padrão, esta exibição recuperará todos os produtos acessíveis e selecionáveis. Se você deseja obter apenas os produtos nos quais pode inserir bugs, deve usar o filtro 'type' da seguinte forma: type='enterable' |
ProductVersions | Permite obter informações sobre as versões de um determinado produto. Consultar 'SELECT * FROM ProductVersions' pode ser lento porque recupera todos os ProductIDs e, em seguida, faz chamadas separadas para cada um deles para obter o ProductVersions. Nesse caso, use a filtragem 'IN' para obter melhor desempenho. |
Users | Permite obter informações sobre contas de usuário. |
Anexos¶
Obtenha dados sobre anexos, com uma lista de bugs e/ou IDs de anexos. Anexos privados só serão devolvidos se você estiver no grupo apropriado ou se for o remetente do anexo.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | O ID numérico do anexo. |
FileName | String | O nome do arquivo do anexo. |
Data | String | Os dados brutos do anexo, codificados como Base64. |
Size | Int | O comprimento (em bytes) do anexo. |
BugId | Int | O ID numérico do bug ao qual o anexo está anexado. |
Summary | String | Uma string curta descrevendo o anexo. |
CreationTime | Datetime | A hora em que o anexo foi criado. |
LastChangeTime | Datetime | A última vez que o anexo foi modificado. |
ContentType | String | O tipo MIME do anexo. |
Creator | String | O nome de login do usuário que criou o anexo. |
IsPrivate | Boolean | 'true' se o anexo for privado (visível apenas para um determinado grupo chamado |
IsObsolete | Boolean | 'true' se o anexo for obsoleto, 'false' caso contrário. |
IsPatch | Boolean | 'true' se o anexo for um patch, 'false' caso contrário. |
BugCcDetail¶
Retorna detalhes do CC de um determinado Bug.
A consultar 'SELECT * FROM BugCcDetail' pode ser lenta se você tiver muitos bugs. Nesse caso, use a filtragem 'IN' para melhor desempenho.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | A ID do membro da lista cc. |
Name | String | O nome do membro da lista de cc. |
RealName | String | O nome 'real' do membro da lista cc. |
Email | String | O e-mail do membro da lista de cc. |
BugId | Int | O ID do bug do qual você está tentando obter os detalhes do CC. |
BugFields¶
Obtenha informações sobre campos de bug válidos.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | Um ID inteiro identificando exclusivamente este campo nesta instalação apenas. |
Name | String | O nome interno deste campo. Este é um identificador exclusivo para este campo. Se este não for um campo personalizado, então este nome será o mesmo em todas as instalações do Bugzilla. |
DisplayName | String | O nome do campo, conforme mostrado na interface do usuário. |
Type | Int | O número do tipo de campo. Os seguintes valores são definidos: '0' - Tipo de campo desconhecido, '1' - Campo de string de linha única, '2' - Campo de valor único, '3' - Campo de valor múltiplo, '4' - Valor de texto de várias linhas, '5' - Campo de data com hora, '6' - Campo de identificação do bug, '7' - Campo Consulte também, '8' - Campo de palavras-chave, '9' - Campo de data, '10' - Campo inteiro |
IsCustom | Boolean | 'true' quando este é um campo personalizado, 'false' caso contrário. |
IsMandatory | Boolean | 'true' se o campo deve ter um valor ao registrar novos bugs. Além disso, campos obrigatórios não podem ter seus valores apagados ao atualizar bugs. |
IsOnBugEntry | Boolean | Para campos personalizados, isso é 'verdadeiro' se o campo for exibido quando você inserir um novo bug. Para campos padrão, isso é sempre 'falso', mesmo que o campo apareça ao inserir um bug. |
VisibilityField | String | O nome de um campo que controla a visibilidade desse campo na interface do usuário. Este campo só aparece na interface do usuário quando o campo nomeado é igual a um dos valores é VisibilityValues. Pode ser nulo. |
ValueField | String | O nome do campo que controla se determinados valores do campo são mostrados ou não na interface do usuário. Pode ser nulo. |
VisibilityValues | String | Este campo só é mostrado quando o campo_visibilidade corresponde a um desses valores de string. Quando VisibilityField é nulo, esta é uma matriz vazia. |
Values | String | Os valores legais para campos de tipo de seleção (suspenso e seleção múltipla). Isso também é preenchido para os campos Componente, Versão, TargetMilestone e Palavras-chave, mas não para o campo Produto. |
BugHistory¶
Retorna informações sobre o histórico do bug que você especificou.
A consultar 'SELECT * FROM BugHistory' pode ser lenta se você tiver muitos bugs. Nesse caso, use a filtragem 'IN' para melhor desempenho.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Who | String | O nome de login do usuário que executou a alteração do bug. |
When | Datetime | A data em que a atividade/alteração do bug ocorreu. |
FieldName | String | O nome do campo de bug que foi alterado. |
Was | String | O valor anterior do campo de bug que foi excluído pela alteração. |
Became | String | O novo valor do campo de bug que foi adicionado pela alteração. |
AttachmentId | Int | O ID do anexo que foi alterado. Isso só tem valor se a alteração for para um anexo. |
BugId | Int | O ID do bug. |
Insetos¶
Obtenha informações sobre seus bugs.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id | Int | O nome de login do usuário que executou a alteração do bug. |
Summary | String | O resumo deste bug. |
AssignedTo | String | O nome de login do usuário a quem o bug foi atribuído. |
Status | String | O status atual do bug. |
AliasAggregate | String | Os aliases exclusivos desse bug. |
ActualTime | Double | O número total de horas que esse bug levou até agora. Se você não estiver no grupo de controle de tempo, este campo não será incluído no valor de retorno. |
AssignedToId | Int | A ID do usuário a quem o bug foi atribuído |
AssignedToRealName | String | O nome 'real' do usuário a quem o bug foi atribuído. |
Classification | String | O nome da classificação atual em que o bug está.TABLEROWEND |
Component | String | O nome do componente ao qual este bug pertence. |
CreationTime | Datetime | Quando o bug foi criado. |
Creator | String | O nome de login da pessoa que registrou este bug (o relator). |
CreatorId | Int | O ID da pessoa que registrou este bug (o relator). |
Deadline | String | O dia em que esse bug deve ser concluído, no formato AAAA-MM-DD. |
DuplicateOf | Int | O ID do bug do qual esse bug é uma duplicata. Se este bug não for uma duplicata de nenhum bug, será nulo. |
EstimatedTime | Double | O número de horas que foi estimado que esse bug levaria. Se você não estiver no grupo de controle de tempo, este campo não será incluído no valor de retorno. |
IsCcAccessible | Boolean | Se verdadeiro, este bug pode ser acessado por membros da lista CC, mesmo que eles não estejam nos grupos aos quais o bug está restrito. |
IsConfirmed | Boolean | 'true' se o bug foi confirmado. Normalmente, isso significa que o bug em algum momento foi movido do status 'NÃO CONFIRMADO' para outro status aberto. |
IsOpen | Boolean | 'true' true se este bug estiver aberto, 'false' se estiver fechado. |
IsCreatorAccessible | Boolean | Se verdadeiro, este bug pode ser acessado pelo criador do bug, mesmo que ele não seja membro dos grupos aos quais o bug está restrito. |
LastChangeTime | Datetime | Quando o bug foi alterado pela última vez. |
CreatorRealName | String | O nome real da pessoa que registrou esse bug (o repórter). |
CreatorName | String | O nome da pessoa que registrou este bug (o relator). |
CreatorEmail | String | O e-mail da pessoa que registrou este bug (o relator). |
OperatingSystem | String | O nome do sistema operacional no qual o bug foi arquivado. |
Platform | String | O nome da plataforma (hardware) na qual o bug foi arquivado. |
Priority | String | A prioridade do bug. |
Product | String | O nome do produto em que esse bug está.TABLEROWEND |
QAContact | String | O nome de login do contato de controle de qualidade atual no bug. |
RemainingTime | Double | O número de horas de trabalho restantes até que o trabalho neste bug seja concluído. Se você não estiver no grupo de controle de tempo, este campo não será incluído no valor de retorno. |
Resolution | String | A resolução atual do bug ou uma string vazia se o bug estiver aberto. |
Severity | String | A gravidade atual do bug. |
TargetMilestone | String | O marco que este bug deve ser corrigido por, ou para bugs fechados, o marco para o qual foi corrigido. |
UpdateToken | String | O token que você teria que passar para a página process_bug.cgi para atualizar este bug. Isso muda toda vez que o bug é atualizado. Este campo não é retornado para usuários desconectados. |
URL | String | Uma URL que demonstra o problema descrito no bug ou está de alguma forma relacionada ao relatório do bug. |
Version | String | A versão contra a qual o bug foi relatado. |
Whiteboard | String | O valor do |
BlocksAggregate | String | Os IDs dos bugs que são |
CCAggregate | String | Os nomes de login dos usuários na lista CC deste bug. |
DependsOnAggregate | String | Os IDs dos bugs que esse bug |
KeywordsAggregate | String | Cada palavra-chave que está neste bug. |
SeeAlsoAggregate | String | As URLs no campo Consulte também sobre o bug. |
Comentários¶
Permite que você obtenha dados sobre comentários, dado um ID de bug ou ID de comentário.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | O ID exclusivo globalmente para o comentário. |
BugId | Int | A ID do bug em que este comentário está. |
AttachmentId | Int | Se o comentário foi feito em um anexo, este será o ID desse anexo. Caso contrário, será nulo. |
Text | String | O texto real do comentário. |
Count | Int | O número do comentário local para o bug. A descrição é 0, os comentários começam com 1. |
Creator | String | O nome de login do autor do comentário. |
CreationTime | Datetime | A hora (no fuso horário do Bugzilla) em que o comentário foi adicionado. |
IsPrivate | Boolean | 'true' se este comentário for privado (visível apenas para um determinado grupo chamado |
ComentárioTags¶
Obtenha informações sobre as tags definidas atualmente para um comentário.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Tag | String | A marca de comentário que correspondeu à consultar especificada. |
Query | String | A consultar especificada. |
ComponentFlagTypes¶
Obtenha informações sobre os tipos de sinalizadores de um componente.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | O ID do tipo de sinalizador. |
FlagName | String | O nome do tipo de sinalizador. |
Description | String | A descrição do flagtype. |
CcList | String | A lista CC concatenada para o flagtype, como uma única string. |
SortKey | Int | A chave de classificação do tipo de sinalizador. |
IsActive | Boolean | Se o flagtype está ativo ou desabilitado. Os sinalizadores que estão em um tipo de sinalizador desativado não são excluídos. Isso apenas impede que você adicione novos sinalizadores a ele. |
IsRequestable | Boolean | Se você pode solicitar o tipo de sinalizador fornecido (ou seja, se o sinalizador '?' está disponível ou não). |
IsRequesteeble | Boolean | Se você pode perguntar a alguém especificamente ou não. |
IsMultiplicable | Boolean | Se você pode ter mais de um sinalizador para determinado tipo de sinalizador em um determinado bug/anexo. |
GrantGroup | Int | O ID do grupo que tem permissão para conceder/negar sinalizadores desse tipo. Se o item não for incluído, todos os usuários poderão conceder/negar esse sinalizador. |
RequestGroup | Int | O ID do grupo que tem permissão para solicitar o sinalizador se o sinalizador for do tipo solicitável. Se o item não estiver incluído, todos os usuários poderão solicitar este sinalizador. |
ProductName | String | O produto que contém o componente em que esses sinalizadores estão.TABLEROWEND |
ComponentName | String | O componente em que esses sinalizadores estão.TABLEROWEND |
Type | String | Se este tipo de sinalizador pertence a um 'bug' ou a um 'anexo' |
Bandeiras¶
Obtenha informações sobre os sinalizadores de um anexo ou os sinalizadores de um bug.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | O ID da bandeira. |
Name | String | O nome da bandeira. |
TypeId | Int | O ID do tipo do sinalizador. |
Status | String | O status atual da bandeira. |
Setter | String | O nome de login do usuário que criou ou modificou o sinalizador pela última vez. |
CreationDate | Datetime | O timestamp quando este sinalizador foi originalmente criado. |
ModificationDate | Datetime | O timestamp quando o sinalizador foi modificado pela última vez. |
BugId | Int | O ID da bandeira. |
AttachmentId | Int | O ID da bandeira. |
Grupos¶
Retorna informações sobre os grupos do Bugzilla.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | O ID inteiro exclusivo que o Bugzilla usa para identificar este grupo. Mesmo que o nome do grupo mude, esse ID permanecerá o mesmo. |
Name | String | O nome do grupo. |
Description | String | A descrição do grupo. |
IsBugGroup | Int | Se este grupo deve ser usado para relatórios de bug ou é apenas administrativo específico. |
UserRegExp | String | Uma expressão regular que permite que os usuários sejam adicionados a este grupo se seus logins corresponderem. |
IsActive | Boolean | Se este grupo está atualmente ativo ou não. |
Membership | Int | Defina como 1 para obter os usuários do grupo. Este campo não contém nenhuma informação. |
Users | String | Objetos de usuário que são membros deste grupo; retornado apenas se o usuário definir o parâmetro 'Associação' como 1. Voltar para o início |
Componentes do Produto¶
Obter informações sobre os componentes de um produto.
Consultar 'SELECT * FROM ProductComponents' pode ser lento porque recupera todos os ProductIDs e faz chamadas separadas para cada um deles para obter os ProductComponents. Nesse caso, use a filtragem 'IN' para obter melhor desempenho.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | Um ID inteiro identificando exclusivamente o componente apenas nesta instalação. |
Name | String | O nome do componente. Este é um identificador exclusivo para este componente. |
Description | String | Uma descrição do componente, que pode conter HTML. |
DefaulAssignedTo | String | O nome de login do usuário a quem os novos bugs serão atribuídos por padrão. |
DefaultQAContact | String | O nome de login do usuário que será definido como o contato QA para novos bugs por padrão. String vazia se o contato de QA não estiver definido. |
SortKey | Int | Os componentes, quando exibidos em uma lista, são classificados primeiro por esse número inteiro e depois por seu nome. |
IsActive | Boolean | Um booleano que indica se o componente está ativo. Componentes inativos não são habilitados para novos bugs. |
ProductId | Int | O ID do produto ao qual este componente pertence. |
ProductName | String | O nome do produto ao qual este componente pertence. |
Marcos do Produto¶
Obtenha informações sobre os marcos de um determinado produto.
Consultar 'SELECT * FROM ProductMilestones' pode ser lento porque recupera todos os ProductIDs e, em seguida, faz chamadas separadas para cada um deles para obter os ProductMilestones. Nesse caso, use a filtragem 'IN' para obter melhor desempenho.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | Um ID inteiro identificando exclusivamente este marco. |
Name | String | O nome do marco do produto. |
IsActive | Boolean | Um booleano que indica se este marco do produto está ativo. |
SortKey | Int | A chave de classificação deste marco do produto. |
ProductId | Int | O ID do produto ao qual este marco pertence. |
ProductName | String | O nome do produto ao qual este marco pertence. |
Produtos¶
Liste os produtos disponíveis e obtenha informações sobre eles.
Por padrão, esta exibição recuperará todos os produtos acessíveis e selecionáveis. Se você deseja obter apenas os produtos nos quais pode inserir bugs, deve usar o filtro 'type' como este: type='enterable'
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | Um ID inteiro identificando exclusivamente o produto apenas nesta instalação. |
Name [KEY] | String | O nome do produto. Este é um identificador exclusivo para o produto. |
Description | String | Uma descrição do produto, que pode conter HTML. |
IsActive | Boolean | Um booleano que indica se o produto está ativo. |
Classification | String | O nome da classificação do produto. |
DefaultMilestone | String | O nome do marco padrão do produto. |
HasUnconfirmed | Boolean | Indica se o status de bug NÃO CONFIRMADO está disponível para este produto. |
Type | String | Informações de retorno sobre tipos específicos de produtos, como 'acessível', 'selecionável' ou 'acessável' |
Versões do Produto¶
Permite obter informações sobre as versões de um determinado produto.
Consultar 'SELECT * FROM ProductVersions' pode ser lento porque recupera todos os ProductIDs e, em seguida, faz chamadas separadas para cada um deles para obter o ProductVersions. Nesse caso, use a filtragem 'IN' para obter melhor desempenho.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | Um ID inteiro que identifica exclusivamente a versão deste produto. |
Name | String | O nome da versão do produto. |
IsActive | Boolean | Um booleano que indica se esta versão do produto está ativa. |
SortKey | Int | A chave de classificação desta versão do produto. |
ProductId | Int | O ID do produto ao qual esta versão pertence. |
ProductName | String | O nome do produto ao qual esta versão pertence. |
Usuários¶
Permite obter informações sobre contas de usuário.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id [KEY] | Int | O ID inteiro exclusivo que o Bugzilla usa para representar esse usuário. Mesmo que o nome de login do usuário mude, isso não mudará. |
Name | String | O nome de login do usuário. |
RealName | String | O nome real do usuário. Pode estar em branco. |
Email | String | O endereço e-mail do usuário. |
CanLogin | Boolean | Um valor booleano para indicar se o usuário pode fazer login no Bugzilla. |
EmailEnabled | Boolean | Um valor booleano para indicar se o e-mail relacionado ao bug será enviado ao usuário ou não. |
LoginDeniedText | String | Um campo de texto que contém o motivo para desabilitar o login de um usuário no Bugzilla. Se estiver vazio, a conta do usuário está habilitada; caso contrário, é desabilitado/fechado. |
SavedSearches | String | Pesquisas salvas do usuário. |
SavedReports | String | Relatórios salvos do usuário. |
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 os metadados do banco de dados para o Bugzilla:
- 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¶
Nome | Tipo | Descrição |
---|---|---|
CatalogName | String | O nome do banco de dados. |
Sys_schemas¶
Lista os esquemas disponíveis.
A consultar a seguir recupera todos os esquemas disponíveis:
SELECT * FROM sys_schemas
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
CatalogName | String | O nome do banco de dados. |
SchemaName | String | O nome do esquema. |
Sys_tables¶
Lista as tabelas disponíveis.
A consultar a seguir recupera as tabelas e exibições disponíveis:
SELECT * FROM sys_tables
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
CatalogName | String | O banco de dados que contém a tabela ou exibição. |
SchemaName | String | O esquema que contém a tabela ou exibição. |
TableName | String | O nome da tabela ou visualização. |
TableType | String | O tipo de tabela (tabela ou exibição). |
Description | String | Uma descrição da tabela ou exibição. |
IsUpdateable | Boolean | Se a tabela pode ser atualizada. |
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 SampleTable_1:
SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='SampleTable_1'
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
CatalogName | String | O nome do banco de dados que contém a tabela ou exibição. |
SchemaName | String | O esquema que contém a tabela ou exibição. |
TableName | String | O nome da tabela ou exibição que contém a coluna. |
ColumnName | String | O nome da coluna. |
DataTypeName | String | O nome do tipo de dados. |
DataType | Int32 | Um número inteiro indicando o tipo de dados. Esse valor é determinado no tempo de execução com base no ambiente. |
Length | Int32 | O tamanho de armazenamento da coluna. |
DisplaySize | Int32 | A largura máxima normal da coluna designada em caracteres. |
NumericPrecision | Int32 | O número máximo de dígitos em dados numéricos. O comprimento da coluna em caracteres para caracteres e dados de data e hora. |
NumericScale | Int32 | A escala da coluna ou o número de dígitos à direita do ponto decimal. |
IsNullable | Boolean | Se a coluna pode conter null. |
Description | String | Uma breve descrição da coluna. |
Ordinal | Int32 | O número de sequência da coluna. |
IsAutoIncrement | String | Se o valor da coluna é atribuído em incrementos fixos. |
IsGeneratedColumn | String | Se a coluna é gerada. |
IsHidden | Boolean | Se a coluna está oculta. |
IsArray | Boolean | Se a coluna é uma matriz. |
Sys_procedures¶
Lista os procedimentos armazenados disponíveis.
A consultar a seguir recupera os procedimentos armazenados disponíveis:
SELECT * FROM sys_procedures
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
CatalogName | String | O banco de dados que contém o procedimento armazenado. |
SchemaName | String | O esquema que contém o procedimento armazenado. |
ProcedureName | String | O nome do procedimento armazenado. |
Description | String | Uma descrição do procedimento armazenado. |
ProcedureType | String | O tipo do procedimento, como PROCEDURE ou FUNCTION. |
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 SampleProcedure:
SELECT * FROM sys_procedureparameters WHERE ProcedureName='SampleProcedure' AND Direction=1 OR Direction=2
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
CatalogName | String | O nome do banco de dados que contém o procedimento armazenado. |
SchemaName | String | O nome do esquema que contém o procedimento armazenado. |
ProcedureName | String | O nome do procedimento armazenado* contendo o parâmetro. |
ColumnName | String | O nome do procedimento armazenado* parâmetro. |
Direction | Int32 | Um número inteiro correspondente ao tipo do parâmetro: entrada (1), entrada/saída (2) ou saída (4). parâmetros de tipo de entrada/saída podem ser parâmetros de entrada e saída. |
DataTypeName | String | O nome do tipo de dados. |
DataType | Int32 | Um número inteiro indicando o tipo de dados. Esse valor é determinado no tempo de execução com base no ambiente. |
Length | Int32 | O número de caracteres permitido para dados de caractere. O número de dígitos permitidos para dados numéricos. |
NumericPrecision | Int32 | A precisão máxima para dados numéricos. O comprimento da coluna em caracteres para caracteres e dados de data e hora. |
NumericScale | Int32 | O número de dígitos à direita do ponto decimal em dados numéricos. |
IsNullable | Boolean | Se o parâmetro pode conter null. |
IsRequired | Boolean | Se o parâmetro é necessário para a execução do procedimento. |
IsArray | Boolean | Se o parâmetro é uma matriz. |
Description | String | A descrição do parâmetro. |
Ordinal | Int32 | O índice do parâmetro. |
Sys_keycolumns¶
Descreve as chaves primárias e estrangeiras. A consultar a seguir recupera a chave primária da tabela SampleTable_1:
SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='SampleTable_1'
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
CatalogName | String | O nome do banco de dados que contém a chave. |
SchemaName | String | O nome do esquema que contém a chave. |
TableName | String | O nome da tabela que contém a chave. |
ColumnName | String | O nome da coluna chave. |
IsKey | Boolean | Se a coluna é uma chave primária na tabela referenciada no campo TableName. |
IsForeignKey | Boolean | Se a coluna é uma chave estrangeira referenciada no campo TableName. |
PrimaryKeyName | String | O nome da chave primária. |
ForeignKeyName | String | O nome da chave estrangeira. |
ReferencedCatalogName | String | O banco de dados que contém a chave primária. |
ReferencedSchemaName | String | O esquema que contém a chave primária. |
ReferencedTableName | String | A tabela que contém a chave primária. |
ReferencedColumnName | String | O nome da coluna da chave primária. |
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¶
Nome | Tipo | Descrição |
---|---|---|
CatalogName | String | O nome do banco de dados que contém a chave. |
SchemaName | String | O nome do esquema que contém a chave. |
TableName | String | O nome da tabela que contém a chave. |
ColumnName | String | O nome da coluna chave. |
PrimaryKeyName | String | O nome da chave primária. |
ForeignKeyName | String | O nome da chave estrangeira. |
ReferencedCatalogName | String | O banco de dados que contém a chave primária. |
ReferencedSchemaName | String | O esquema que contém a chave primária. |
ReferencedTableName | String | A tabela que contém a chave primária. |
ReferencedColumnName | String | O nome da coluna da chave primária. |
ForeignKeyType | String | Designa se a chave estrangeira é uma chave de importação (aponta para outras tabelas) ou de exportação (referenciada de outras tabelas). |
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¶
Nome | Tipo | Descrição |
---|---|---|
CatalogName | String | O nome do banco de dados que contém o índice. |
SchemaName | String | O nome do esquema que contém o índice. |
TableName | String | O nome da tabela que contém o índice. |
IndexName | String | O nome do índice. |
ColumnName | String | O nome da coluna associada ao índice. |
IsUnique | Boolean | True se o índice for exclusivo. Falso caso contrário. |
IsPrimary | Boolean | Verdadeiro se o índice for uma chave primária. Falso caso contrário. |
Type | Int16 | Um valor inteiro correspondente ao tipo de índice: estatística (0), agrupado (1), hash (2) ou outro (3). |
SortOrder | String | A ordem de classificação: A para crescente ou D para decrescente. |
OrdinalPosition | Int16 | O número de sequência da coluna no índice. |
Sys_connection_props¶
Retorna informações sobre as propriedades de conexão disponíveis e as definidas na string de conexão.
Ao consultar esta tabela, a string de conexão de configuração deve ser usada:
jdbc:cdata:bugzilla:config:
Esta string de conexão permite que você consultar esta tabela sem uma conexão válida.
A consultar a seguir recupera todas as propriedades de conexão que foram definidas na string de conexão ou definidas por meio de um valor padrão:
SELECT * FROM sys_connection_props WHERE Value <> ''
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Name | String | O nome da propriedade de conexão. |
ShortDescription | String | Uma breve descrição. |
Type | String | O tipo de dados da propriedade de conexão. |
Default | String | O valor padrão, se não houver um definido explicitamente. |
Values | String | Uma lista separada por vírgulas de valores possíveis. Um erro de validação é lançado se outro valor for especificado. |
Value | String | O valor que você definiu ou um padrão pré-configurado. |
Required | Boolean | Se a propriedade é necessária para se conectar. |
Category | String | A categoria da propriedade de conexão. |
IsSessionProperty | String | Se a propriedade é uma propriedade de sessão, usada para salvar informações sobre a conexão atual. |
Sensitivity | String | O nível de sensibilidade da propriedade. Isso informa se a propriedade está ofuscada nos formulários de registro e autenticação. |
PropertyName | String | Uma forma truncada em camel case do nome da propriedade de conexão. |
Ordinal | Int32 | O índice do parâmetro. |
CatOrdinal | Int32 | O índice da categoria do parâmetro. |
Hierarchy | String | Mostra as propriedades dependentes associadas que precisam ser definidas juntamente com esta. |
Visible | Boolean | Informa se a propriedade está visível na UI da conexão. |
ETC | String | Diversas informações diversas sobre o imóvel. |
Sys_sqlinfo¶
Descreve o processamento da consultar SELECT que o conector pode transferir para a fonte de dados.
Processamento de Consultas Colaborativas¶
Ao trabalhar com fontes de dados que não suportam SQL-92, você pode consultar a exibição sys_sqlinfo para determinar os recursos de consultar das APIs subjacentes, expressas na sintaxe SQL. O conector transfere o máximo possível do processamento da instrução SELECT para o servidor e, em seguida, processa o restante da consultar na memória.
Descobrindo os Recursos SELECT da Fonte de Dados¶
Abaixo está um exemplo de conjunto de dados de recursos SQL. O conjunto de resultados a seguir indica a funcionalidade SELECT que o conector pode descarregar para a fonte de dados ou processar o lado do cliente. Sua fonte de dados pode suportar sintaxe SQL adicional. Alguns aspectos da funcionalidade SELECT são retornados em uma lista separada por vírgulas, se suportados; caso contrário, a coluna contém NO.
Nome | Descrição | Valores Possíveis |
---|---|---|
AGGREGATE_FUNCTIONS | Funções de agregação suportadas. | AVG , COUNT , MAX , MIN , SUM , DISTINCT |
COUNT | Se a função COUNT é suportada. | YES , NO |
IDENTIFIER_QUOTE_OPEN_CHAR | O caractere de abertura usado para escapar de um identificador. | [ |
IDENTIFIER_QUOTE_CLOSE_CHAR | O caractere de fechamento usado para escapar de um identificador. | ] |
SUPPORTED_OPERATORS | Uma lista de operadores SQL com suporte. | = , > , < , >= , <= , <> , != , LIKE , NOT LIKE , IN , NOT IN , IS NULL , IS NOT NULL , AND , OR |
GROUP_BY | Se GROUP BY é compatível e, em caso afirmativo, o grau de suporte. | NO , NO_RELATION , EQUALS_SELECT , SQL_GB_COLLATE |
STRING_FUNCTIONS | Funções de string suportadas. | LENGTH , CHAR , LOCATE , REPLACE , SUBSTRING , RTRIM , LTRIM , RIGHT , LEFT , UCASE , SPACE , SOUNDEX , LCASE , CONCAT , ASCII , REPEAT , OCTET , BIT , POSITION , INSERT , TRIM , UPPER , REGEXP , LOWER , DIFFERENCE , CHARACTER , SUBSTR , STR , REVERSE , PLAN , UUIDTOSTR , TRANSLATE , TRAILING , TO , STUFF , STRTOUUID , STRING , SPLIT , SORTKEY , SIMILAR , REPLICATE , PATINDEX , LPAD , LEN , LEADING , KEY , INSTR , INSERTSTR , HTML , GRAPHICAL , CONVERT , COLLATION , CHARINDEX , BYTE |
NUMERIC_FUNCTIONS | Funções numéricas suportadas. | ABS , ACOS , ASIN , ATAN , ATAN2 , CEILING , COS , COT , EXP , FLOOR , LOG , MOD , SIGN , SIN , SQRT , TAN , PI , RAND , DEGREES , LOG10 , POWER , RADIANS , ROUND , TRUNCATE |
TIMEDATE_FUNCTIONS | Funções de data/hora suportadas. | NOW , CURDATE , DAYOFMONTH , DAYOFWEEK , DAYOFYEAR , MONTH , QUARTER , WEEK , YEAR , CURTIME , HOUR , MINUTE , SECOND , TIMESTAMPADD , TIMESTAMPDIFF , DAYNAME , MONTHNAME , CURRENT_DATE , CURRENT_TIME , CURRENT_TIMESTAMP , EXTRACT |
REPLICATION_SKIP_TABLES | Indica tabelas ignoradas durante a replicação. | |
REPLICATION_TIMECHECK_COLUMNS | Uma matriz de string contendo uma lista de colunas que serão usadas para verificar (na ordem especificada) para usar como uma coluna modificada durante a replicação. | |
IDENTIFIER_PATTERN | Valor de string que indica qual string é válida para um identificador. | |
SUPPORT_TRANSACTION | Indica se o provedor oferece suporte a transações como confirmação e reversão. | YES , NO |
DIALECT | Indica o dialeto SQL a ser usado. | |
KEY_PROPERTIES | Indica as propriedades que identificam o banco de dados uniforme. | |
SUPPORTS_MULTIPLE_SCHEMAS | Indica se vários esquemas podem existir para o provedor. | YES , NO |
SUPPORTS_MULTIPLE_CATALOGS | Indica se vários catálogos podem existir para o provedor. | YES , NO |
DATASYNCVERSION | A versão do Data Sync necessária para acessar este driver. | Standard , Starter , Professional , Enterprise |
DATASYNCCATEGORY | A categoria Data Sync deste driver. | Source , Destination , Cloud Destination |
SUPPORTSENHANCEDSQL | Se a funcionalidade SQL aprimorada além do que é oferecido pela API é suportada. | TRUE , FALSE |
SUPPORTS_BATCH_OPERATIONS | Se as operações em lote são suportadas. | YES , NO |
SQL_CAP | Todos os recursos SQL suportados para este driver. | SELECT , INSERT , DELETE , UPDATE , TRANSACTIONS , ORDERBY , OAUTH , ASSIGNEDID , LIMIT , LIKE , BULKINSERT , COUNT , BULKDELETE , BULKUPDATE , GROUPBY , HAVING , AGGS , OFFSET , REPLICATE , COUNTDISTINCT , JOINS , DROP , CREATE , DISTINCT , INNERJOINS , SUBQUERIES , ALTER , MULTIPLESCHEMAS , GROUPBYNORELATION , OUTERJOINS , UNIONALL , UNION , UPSERT , GETDELETED , CROSSJOINS , GROUPBYCOLLATE , MULTIPLECATS , FULLOUTERJOIN , MERGE , JSONEXTRACT , BULKUPSERT , SUM , SUBQUERIESFULL , MIN , MAX , JOINSFULL , XMLEXTRACT , AVG , MULTISTATEMENTS , FOREIGNKEYS , CASE , LEFTJOINS , COMMAJOINS , WITH , LITERALS , RENAME , NESTEDTABLES , EXECUTE , BATCH , BASIC , INDEX |
PREFERRED_CACHE_OPTIONS | Um valor de string especifica o cacheOptions preferencial. | |
ENABLE_EF_ADVANCED_QUERY | Indica se o driver oferece suporte direto a consultas avançadas provenientes do Entity Framework. Caso contrário, as consultas serão tratadas no lado do cliente. | YES , NO |
PSEUDO_COLUMNS | Uma matriz de cadeia de caracteres que indica as pseudocolunas disponíveis. | |
MERGE_ALWAYS | Se o valor for verdadeiro, o modo de mesclagem será executado à força no Data Sync. | TRUE , FALSE |
REPLICATION_MIN_DATE_QUERY | Uma consultar de seleção para retornar a data e hora de início da replicação. | |
REPLICATION_MIN_FUNCTION | Permite que um provedor especifique o nome da fórmula a ser usado para executar um min do lado do servidor. | |
REPLICATION_START_DATE | Permite que um provedor especifique uma data de início de replicação. | |
REPLICATION_MAX_DATE_QUERY | Uma consultar de seleção para retornar a data e hora de término da replicação. | |
REPLICATION_MAX_FUNCTION | Permite que um provedor especifique o nome da fórmula a ser usado para executar um máximo do lado do servidor. | |
IGNORE_INTERVALS_ON_INITIAL_REPLICATE | Uma lista de tabelas que ignorará a divisão da replicação em blocos na replicação inicial. | |
CHECKCACHE_USE_PARENTID | Indica se a instrução CheckCache deve ser executada na coluna de chave pai. | TRUE , FALSE |
CREATE_SCHEMA_PROCEDURES | Indica procedimentos armazenados* que pode ser usado para gerar arquivos de esquema. |
A consultar a seguir recupera os operadores que podem ser usados na cláusula WHERE:
SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'
Observe que tabelas individuais podem ter diferentes limitações ou requisitos na cláusula WHERE; consulte o Modelo de Dados para obter mais informações.
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
NAME | String | Um componente da sintaxe SQL ou um recurso que pode ser processado no servidor. |
VALUE | String | Detalhes sobre a sintaxe SQL ou SQL suportada. |
Sys_identity¶
Retorna informações sobre tentativas de modificação.
A consultar a seguir recupera os IDs das linhas modificadas em uma operação em lote:
SELECT * FROM sys_identity
Colunas¶
Nome | Tipo | Descrição |
---|---|---|
Id | String | O ID gerado pelo banco de dados retornado de uma operação de modificação de dados. |
Batch | String | Um identificador para o lote. 1 para uma única operação. |
Operation | String | O resultado da operação no lote: INSERTED, UPDATED ou DELETED. |
Message | String | SUCCESS ou uma mensagem de erro se a atualização no lote falhou. |
Propriedades de Configurações Avançadas¶
As propriedades de configurações avançadas são as várias opções que podem ser usadas para estabelecer uma conexão. Esta seção fornece uma lista completa das opções que você pode configurar. Clique nos links para mais detalhes.
Propriedade | Descrição |
---|---|
URL | A URL para o servidor Bugzilla usado para fazer logon.TABLEROWEND |
APIKey | Uma ApiKey para autenticar em sua conta. As chaves de API podem ser criadas na seção Preferências > Seção Chaves de API. |
Propriedade | Descrição |
---|---|
SSLServerCert | O certificado a ser aceito do servidor ao conectar usando TLS/SSL. |
Propriedade | Descrição |
---|---|
Location | Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados. |
BrowsableSchemas | Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tables=TableA, TableB, TableC. |
Views | Restringe as exibições relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA, ViewB, ViewC. |
Propriedade | Descrição |
---|---|
IncludeCustomFields | Determina se os Campos Personalizados devem ser incluídos como colunas da tabela ou não. |
MaxRows | Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design. |
Other | Essas propriedades ocultas são usadas apenas em casos de uso específicos. |
Pagesize | O número máximo de resultados a serem retornados por página do Bugzilla. |
PseudoColumns | Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela. |
RowScanDepth | O número máximo de linhas a serem verificadas para procurar as colunas disponíveis em uma tabela. |
Timeout | O valor em segundos até que o erro de timeout seja lançado, cancelando a operação. |
Autenticação¶
Esta seção fornece uma lista completa de propriedades de autenticação que você pode configurar.
Propriedade | Descrição |
---|---|
URL | A URL para o servidor Bugzilla usado para fazer logon.TABLEROWEND |
APIKey | Uma ApiKey para autenticar em sua conta. As chaves de API podem ser criadas na seção Preferências > Seção Chaves de API. |
URL¶
A URL para o servidor Bugzilla usado para fazer login.
Tipo de Dados¶
string
Valor Padrão¶
""
Observações¶
A URL para o servidor Bugzilla usado para fazer login.
Chave API¶
Uma ApiKey para autenticar em sua conta. As chaves de API podem ser criadas na seção Preferências > Seção Chaves de API.
Tipo de Dados¶
string
Valor Padrão¶
""
Observações¶
Chave API
SSL¶
Esta seção fornece uma lista completa de propriedades SSL que você pode configurar.
Propriedade | Descrição |
---|---|
SSLServerCert | O certificado a ser aceito do servidor ao conectar usando TLS/SSL. |
SSLServerCert¶
O certificado a ser aceito do servidor ao conectar usando TLS/SSL.
Tipo de Dados¶
string
Valor Padrão¶
""
Observações¶
Se estiver usando uma conexão TLS/SSL, esta propriedade pode ser usada para especificar o certificado TLS/SSL a ser aceito do servidor. Qualquer outro certificado que não seja confiável para a máquina é rejeitado.
Esta propriedade pode assumir as seguintes formas:
Descrição | Exemplo |
---|---|
Um certificado PEM completo (exemplo abreviado para concisão) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
Um caminho para um arquivo local contendo o certificado | C:\cert.cer |
A chave pública (exemplo abreviado para concisão) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
O Thumbprint MD5 (os valores hexadecimais também podem ser separados por espaço ou dois-pontos) | ecadbdda5a1529c58a1e9e09828d70e4 |
A impressão digital SHA1 (os valores hexadecimais também podem ser separados por espaço ou dois-pontos) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
Se não for especificado, qualquer certificado confiável pela máquina será aceito.
Os certificados são validados como confiáveis pela máquina com base no armazenamento confiável do sistema. O armazenamento confiável usado é o valor 'javax.net.ssl.trustStore' especificado para o sistema. Se nenhum valor for especificado para esta propriedade, o armazenamento confiável padrão do Java será usado (por exemplo, JAVA_HOME\lib\security\cacerts).
Use '*' para indicar a aceitação de todos os certificados. Observe que isso não é recomendado devido a questões de segurança.
Esquema¶
Esta seção fornece uma lista completa de propriedades de esquema que você pode configurar.
Propriedade | Descrição |
---|---|
Location | Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados. |
BrowsableSchemas | Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tables=TableA, TableB, TableC. |
Views | Restringe as visualizações relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA, ViewB, ViewC. |
Localização¶
Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.
Tipo de Dados¶
string
Valor Padrão¶
"%APPDATA%\\\Bugzilla Data Provider\\Schema"
Observações¶
O caminho para um diretório que contém os arquivos de esquema para o conector (arquivos .rsd para tabelas e exibições, arquivos .rsb para procedimentos armazenados). A localização da pasta pode ser um caminho relativo a partir da localização do executável. O Location
a propriedade só é necessária se você quiser personalizar definições (por exemplo, alterar um nome de coluna, ignorar uma coluna e assim por diante) ou estender o modelo de dados com novas tabelas, exibições ou procedimentos armazenados.
Se não for especificado, o local padrão é "%APPDATA%\\ Bugzilla Data Provider\Schema" com %APPDATA%
sendo definido para o diretório de configuração do usuário:
Plataforma | %APPDATA% |
---|---|
Windows | O valor da variável de ambiente APPDATA |
Mac | ~/Biblioteca/Suporte de aplicativos |
Linux | ~/.config |
Esquemas Navegáveis¶
Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
Tipo de Dados¶
string
Valor Padrão¶
""
Observações¶
Listar os esquemas de bancos de dados pode ser caro. Fornecer uma lista de esquemas na string de conexão melhora o desempenho.
Tabelas¶
Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tabelas=TabelaA,TabelaB,TabelaC.
Tipo de Dados¶
string
Valor Padrão¶
""
Observações¶
Listar as tabelas de alguns bancos de dados pode ser caro. Fornecer uma lista de tabelas na string de conexão melhora o desempenho do conector.
Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitos para trabalhar.
Especifique as tabelas que deseja em uma lista separada por vírgulas. Cada tabela deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.
Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.
Visualizações¶
Restringe as exibições relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA,ViewB,ViewC.
Tipo de Dados¶
string
Valor Padrão¶
""
Observações¶
Listar as exibições de alguns bancos de dados pode ser caro. Fornecer uma lista de exibições na string de conexão melhora o desempenho do conector.
Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitos para trabalhar.
Especifique as exibições desejadas em uma lista separada por vírgulas. Cada exibição deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.
Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.
Diversos¶
Esta seção fornece uma lista completa de diversas propriedades que você pode configurar.
Propriedade | Descrição |
---|---|
IncludeCustomFields | Determina se os Campos Personalizados devem ser incluídos como colunas da tabela ou não. |
MaxRows | Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design. |
Other | Essas propriedades ocultas são usadas apenas em casos de uso específicos. |
Pagesize | O número máximo de resultados a serem retornados por página do Bugzilla. |
PseudoColumns | Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela. |
RowScanDepth | O número máximo de linhas a serem verificadas para procurar as colunas disponíveis em uma tabela. |
Timeout | O valor em segundos até que o erro de timeout seja lançado, cancelando a operação. |
IncludeCustomFields¶
Determina se os Campos Personalizados devem ser incluídos como colunas da tabela ou não.
Tipo de Dados¶
string
Valor Padrão¶
"false"
Observações¶
É possível criar campos personalizados no Bugzilla. Para recuperar seus valores, você pode definir IncludeCustomFields=true como uma propriedade de conexão. Isso listará os campos personalizados criados como colunas da tabela.
MaxRows¶
Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.
Tipo de Dados¶
int
Valor Padrão¶
-1
Observações¶
Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.
Outro¶
Essas propriedades ocultas são usadas apenas em casos de uso específicos.
Tipo de Dados¶
string
Valor Padrão¶
""
Observações¶
As propriedades listadas abaixo estão disponíveis para casos de uso específicos. Os casos de uso e a funcionalidade normais do driver não devem exigir essas propriedades.
Especifique várias propriedades em uma lista separada por ponto e vírgula.
Integração e Formatação¶
Propriedade | Descrição |
---|---|
DefaultColumnSize | Define o comprimento padrão dos campos de string quando a fonte de dados não fornece o comprimento da coluna nos metadados. O valor padrão é 2000. Voltar para o início |
ConvertDateTimeToGMT | Determina se os valores de data e hora devem ser convertidos em GMT, em vez da hora local da máquina. |
RecordToFile=filename | Registra a transferência de dados do soquete subjacente para o arquivo especificado. |
Tamanho da Página¶
O número máximo de resultados a serem retornados por página do Bugzilla.
Tipo de Dados¶
int
Valor Padrão¶
-1
Observações¶
O Pagesize
a propriedade afeta o número máximo de resultados a serem retornados por página do Bugzilla. Definir um valor mais alto pode resultar em melhor desempenho ao custo de memória adicional alocada por página consumida.
Pseudocolunas¶
Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela.
Tipo de Dados¶
string
Valor Padrão¶
""
Observações¶
Essa configuração é particularmente útil no Entity Framework, que não permite definir um valor para uma pseudocoluna, a menos que seja uma coluna de tabela. O valor dessa configuração de conexão está no formato "Table1=Column1, Table1=Column2, Table2=Column3". Você pode usar o caractere "*" para incluir todas as tabelas e todas as colunas; por exemplo, "*=*".
RowScanDepth¶
O número máximo de linhas a serem verificadas para procurar as colunas disponíveis em uma tabela.
Tipo de Dados¶
int
Valor Padrão¶
40
Observações¶
As colunas em uma tabela devem ser determinadas pela varredura das linhas da tabela. Esse valor determina o número máximo de linhas que serão verificadas.
Definir um valor alto pode diminuir o desempenho. Definir um valor baixo pode impedir que o tipo de dados seja determinado corretamente, especialmente quando houver dados nulos.
Tempo Esgotado¶
O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.
Tipo de Dados¶
int
Valor Padrão¶
60
Observações¶
Se Timeout
= 0, as operações não expiram. As operações são executadas até serem concluídas com êxito ou até encontrarem uma condição de erro.
Se Timeout
expira e a operação ainda não está concluída, o conector lança uma exceção.