Detalles de Conexión de Bugzilla¶
Introducción¶
Versión del conector
Esta documentación se basa en la versión 21.0.8383 del conector.
Empezando¶
Compatibilidad con la versión de Bugzilla
El conector aprovecha la API de Bugzilla para habilitar el acceso bidireccional a Bugzilla.
Establecer una Conexión¶
Conexión a Bugzilla¶
Puede utilizar la interfaz de usuario del desarrollador de Bugzilla para establecer una conexión con su instancia de Bugzilla. Para obtener detalles sobre este proceso, consulte Conectarse a Bugzilla.
Conexión a Bugzilla¶
Esta sección documenta cómo proporcionar autenticación para su tipo de cuenta.
Autenticar una Cuenta de Bugzilla¶
Puede autenticarse en su cuenta de Bugzilla utilizando estos dos parámetros:
URL:
Esta es la URL de su página de desarrollador de Bugzilla (laHome
página).ApiKey:
Las claves API se pueden generar a partir dePreferences > API Keys
sección de tu página de desarrollador de Bugzilla.
Características Avanzadas¶
Esta sección detalla una selección de funciones avanzadas del conector Bugzilla.
Vistas definidas por el usuario
El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.
Configuración SSL
Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert
propiedad en "Opciones de cadena de conexión" para obtener más información.
Apoderado
Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings
casilla de verificación en la pantalla de configuración de la conexión.
Vistas Definidas por el Usuario¶
El conector Jitterbit para Bugzilla le permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.
Hay dos formas de crear vistas definidas por el usuario:
- Cree un archivo de configuración con formato JSON que defina las vistas que desea.
- Declaraciones DDL.
Definición de Vistas Utilizando un Archivo de Configuración¶
Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json
. El conector detecta automáticamente las vistas especificadas en este archivo.
También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews
propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.
Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:
- Cada elemento raíz define el nombre de una vista.
- Cada elemento raíz contiene un elemento hijo, llamado
query
, que contiene la consultar SQL personalizada para la vista.
Por ejemplo:
{
"MyView": {
"query": "SELECT * FROM SampleTable_1 WHERE MyColumn = 'value'"
},
"MyView2": {
"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
}
}
Utilizar el UserDefinedViews
propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:
"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"
Esquema para Vistas Definidas por el Usuario¶
Las vistas definidas por el usuario se exponen en UserViews
esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName
propiedad.
Trabajar con Vistas Definidas por el Usuario¶
Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers
solo enumera clientes en Raleigh:
SELECT * FROM Customers WHERE City = 'Raleigh';
Un ejemplo de una consultar al controlador:
SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';
Dando como resultado la consultar efectiva a la fuente:
SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';
Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.
Configuración SSL¶
Personalización de la Configuración SSL¶
De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.
Para especificar otro certificado, consulte SSLServerCert
propiedad de los formatos disponibles para hacerlo.
Modelo de Datos¶
El Conector Jitterbit para Bugzilla modela los objetos de Bugzilla como tablas y vistas relacionales. Un objeto Bugzilla tiene relaciones con otros objetos en las tablas, y estas relaciones se expresan a través de claves foráneas.
Las siguientes secciones muestran los objetos de API disponibles y brindan más información sobre cómo ejecutar SQL en las APIs de Bugzilla.
Los esquemas para la mayoría de los objetos de la base de datos se definen en archivos de configuración simples basados en texto.
El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT a las APIs de Bugzilla y luego procesa el resto de la consultar en la memoria. Ver SupportEnhancedSQL
para obtener más información sobre cómo el conector elude las limitaciones de la API con el procesamiento del lado del cliente en memoria.
Puntos de Vista¶
Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.
Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.
Conector Jitterbit para Vistas de Bugzilla¶
Nombre | Descripción |
---|---|
Attachments | Obtenga datos sobre archivos adjuntos, dada una lista de errores y/o ID de archivos adjuntos. Los archivos adjuntos privados solo se devolverán si se encuentra en el grupo apropiado o si es el remitente del archivo adjunto. |
BugCcDetail | Devuelve detalles del CC de un determinado Bug. La consultar 'SELECT * FROM BugCcDetail' podría ser lenta si tiene muchos errores. En ese caso, use el filtrado 'IN' para un mejor rendimiento. |
BugFields | Obtenga información sobre campos de errores válidos. |
BugHistory | Devuelve información sobre el historial del error que especificó. La consultar 'SELECT * FROM BugHistory' podría ser lenta si tiene muchos errores. En ese caso, use el filtrado 'IN' para un mejor rendimiento. |
Bugs | Obtenga información sobre sus errores. |
Comments | Le permite obtener datos sobre comentarios, dado un ID de error o ID de comentario. |
CommentTags | Obtenga información sobre las etiquetas configuradas actualmente para un comentario. |
ComponentFlagTypes | Obtenga información sobre los tipos de marcas de un componente. |
Flags | Obtenga información sobre los indicadores de un archivo adjunto o los indicadores de un error. |
Groups | Devuelve información sobre los grupos de Bugzilla. |
ProductComponents | Obtener información sobre los componentes de un producto. Consultar 'SELECT * FROM ProductComponents' podría ser lento porque recupera todos los ProductID y luego realiza llamadas separadas para cada uno de ellos para obtener los ProductComponents. En ese caso, use el filtrado 'IN' para un mejor rendimiento. |
ProductMilestones | Obtener información sobre los hitos de un determinado producto. Consultar 'SELECT * FROM ProductMilestones' podría ser lento porque recupera todos los ProductID y luego realiza llamadas separadas para cada uno de ellos para obtener los ProductMilestones. En ese caso, use el filtrado 'IN' para un mejor rendimiento. |
Products | Enumere los productos disponibles y obtenga información sobre ellos. De forma predeterminada, esta vista recuperará todos los productos accesibles y seleccionables. Si desea obtener solo los productos contra los que puede ingresar errores, debe usar el filtro 'tipo' de esta manera: type='enterable' |
ProductVersions | Le permite obtener información sobre las versiones de un determinado producto. Consultar 'SELECT * FROM ProductVersions' podría ser lento porque recupera todos los ProductID y luego realiza llamadas separadas para cada uno de ellos para obtener ProductVersions. En ese caso, use el filtrado 'IN' para un mejor rendimiento. |
Users | Le permite obtener información sobre las cuentas de usuario. |
Archivos Adjuntos¶
Obtenga datos sobre archivos adjuntos, dada una lista de errores y/o ID de archivos adjuntos. Los archivos adjuntos privados solo se devolverán si se encuentra en el grupo apropiado o si es el remitente del archivo adjunto.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | El ID numérico del archivo adjunto. |
FileName | String | El nombre de archivo del archivo adjunto. |
Data | String | Los datos sin procesar del archivo adjunto, codificados como Base64. |
Size | Int | La longitud (en bytes) del archivo adjunto. |
BugId | Int | El ID numérico del error al que está adjunto el archivo adjunto. |
Summary | String | Una cadena corta que describe el archivo adjunto. |
CreationTime | Datetime | La hora en que se creó el archivo adjunto. |
LastChangeTime | Datetime | La última vez que se modificó el archivo adjunto. |
ContentType | String | El tipo MIME del archivo adjunto. |
Creator | String | El nombre de inicio de sesión del usuario que creó el archivo adjunto. |
IsPrivate | Boolean | 'verdadero' si el archivo adjunto es privado (solo visible para un determinado grupo llamado |
IsObsolete | Boolean | 'verdadero' si el archivo adjunto está obsoleto, 'falso' en caso contrario. |
IsPatch | Boolean | 'verdadero' si el archivo adjunto es un parche, 'falso' en caso contrario. |
ErrorCcDetalle¶
Devuelve detalles del CC de un determinado Bug.
La consultar 'SELECT * FROM BugCcDetail' podría ser lenta si tiene muchos errores. En ese caso, use el filtrado 'IN' para un mejor rendimiento.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | El ID del miembro de la lista cc. |
Name | String | El nombre del miembro de la lista cc. |
RealName | String | El nombre 'real' del miembro de la lista cc. |
Email | String | El correo electrónico del miembro de la lista cc. |
BugId | Int | El ID del error del que intenta obtener los detalles de CC. |
Campos de Errores¶
Obtenga información sobre campos de errores válidos.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | Un ID entero que identifica de forma única este campo en esta instalación únicamente. |
Name | String | El nombre interno de este campo. Este es un identificador único para este campo. Si este no es un campo personalizado, entonces este nombre será el mismo en todas las instalaciones de Bugzilla. |
DisplayName | String | El nombre del campo, tal como se muestra en la interfaz de usuario. |
Type | Int | El número del tipo de campo. Se definen los siguientes valores: '0': tipo de campo desconocido, '1': campo de cadena de una sola línea, '2': campo de valor único, '3': campo de valor múltiple, '4': valor de texto de línea múltiple, '5': campo de fecha con hora, '6': campo de ID de error, '7': campo Ver también, '8': campo de palabras clave, '9': campo de fecha, '10': campo de número entero |
IsCustom | Boolean | 'verdadero' cuando se trata de un campo personalizado, 'falso' en caso contrario. |
IsMandatory | Boolean | 'verdadero' si el campo debe tener un valor al presentar nuevos errores. Además, los campos obligatorios no pueden tener su valor borrado al actualizar errores. |
IsOnBugEntry | Boolean | Para los campos personalizados, esto es 'verdadero' si el campo se muestra cuando ingresa un nuevo error. Para los campos estándar, actualmente siempre es 'falso', incluso si el campo aparece al ingresar un error. |
VisibilityField | String | El nombre de un campo que controla la visibilidad de este campo en la interfaz de usuario. Este campo solo aparece en la interfaz de usuario cuando el campo con nombre es igual a uno de los valores VisibilityValues. Puede ser nulo. |
ValueField | String | El nombre del campo que controla si los valores particulares del campo se muestran o no en la interfaz de usuario. Puede ser nulo. |
VisibilityValues | String | Este campo solo se muestra cuando visibilidad_field coincide con uno de estos valores de cadena. Cuando VisibilityField es nulo, entonces esta es una matriz vacía. |
Values | String | Los valores legales para los campos de tipo de selección (desplegable y de selección múltiple). Esto también se completa para los campos Componente, Versión, TargetMilestone y Palabras clave, pero no para el campo Producto. |
Historial de Errores¶
Devuelve información sobre el historial del error que especificó.
La consultar 'SELECT * FROM BugHistory' podría ser lenta si tiene muchos errores. En ese caso, use el filtrado 'IN' para un mejor rendimiento.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Who | String | El nombre de inicio de sesión del usuario que realizó el cambio de error. |
When | Datetime | La fecha en que ocurrió la actividad/el cambio del error. |
FieldName | String | El nombre del campo de error que ha cambiado. |
Was | String | El valor anterior del campo de error que ha sido eliminado por el cambio. |
Became | String | El nuevo valor del campo de error que ha sido agregado por el cambio. |
AttachmentId | Int | El ID del archivo adjunto que se modificó. Esto tiene un valor solo si el cambio fue en un archivo adjunto. |
BugId | Int | El ID del error. |
Insectos¶
Obtenga información sobre sus errores.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id | Int | El nombre de inicio de sesión del usuario que realizó el cambio de error. |
Summary | String | El resumen de este error. |
AssignedTo | String | El nombre de inicio de sesión del usuario al que está asignado el error. |
Status | String | El estado actual del error. |
AliasAggregate | String | Los alias únicos de este error. |
ActualTime | Double | El número total de horas que este error ha tardado hasta ahora. Si no está en el grupo de seguimiento de tiempo, este campo no se incluirá en el valor devuelto. |
AssignedToId | Int | El ID del usuario al que se le asigna el error |
AssignedToRealName | String | El nombre 'real' del usuario a quien se le asignó el error. |
Classification | String | El nombre de la clasificación actual en la que se encuentra el error. |
Component | String | El nombre del componente al que pertenece este error. |
CreationTime | Datetime | Cuando se creó el error. |
Creator | String | El nombre de inicio de sesión de la persona que presentó este error (el informador). |
CreatorId | Int | La identificación de la persona que presentó este error (el reportero). |
Deadline | String | El día en que se debe completar este error, en el formato AAAA-MM-DD. |
DuplicateOf | Int | El ID de error del error del que este error es un duplicado. Si este error no es un duplicado de ningún error, será nulo. |
EstimatedTime | Double | El número de horas que se estimó que tardaría este error. Si no está en el grupo de seguimiento de tiempo, este campo no se incluirá en el valor de retorno. |
IsCcAccessible | Boolean | Si es verdadero, los miembros de la lista CC pueden acceder a este error, incluso si no están en los grupos a los que está restringido el error. |
IsConfirmed | Boolean | 'verdadero' si se ha confirmado el error. Por lo general, esto significa que el error en algún momento se ha movido del estado 'NO CONFIRMADO' a otro estado abierto. |
IsOpen | Boolean | 'verdadero' verdadero si este error está abierto, 'falso' si está cerrado. |
IsCreatorAccessible | Boolean | Si es verdadero, el creador del error puede acceder a este error, incluso si no es miembro de los grupos a los que está restringido el error. |
LastChangeTime | Datetime | Cuándo se modificó el error por última vez. |
CreatorRealName | String | El nombre real de la persona que presentó este error (el reportero). |
CreatorName | String | El nombre de la persona que presentó este error (el reportero). |
CreatorEmail | String | El correo electrónico de la persona que presentó este error (el reportero). |
OperatingSystem | String | El nombre del sistema operativo contra el que se presentó el error. |
Platform | String | El nombre de la plataforma (hardware) contra la que se presentó el error. |
Priority | String | La prioridad del bicho. |
Product | String | El nombre del producto en el que se encuentra este error. |
QAContact | String | El nombre de inicio de sesión del contacto de control de calidad actual en el error. |
RemainingTime | Double | El número de horas de trabajo restantes hasta que se complete el trabajo en este error. Si no está en el grupo de seguimiento de tiempo, este campo no se incluirá en el valor de retorno. |
Resolution | String | La resolución actual del error, o una cadena vacía si el error está abierto. |
Severity | String | La gravedad actual del error. |
TargetMilestone | String | El hito por el que se supone que se corrige este error, o para errores cerrados, el hito para el que se corrigió. |
UpdateToken | String | El token que tendría que pasar a la página process_bug.cgi para actualizar este error. Esto cambia cada vez que se actualiza el error. Este campo no se devuelve a los usuarios que han cerrado la sesión. |
URL | String | Una URL que demuestre el problema descrito en el error o que esté relacionada de alguna manera con el informe del error. |
Version | String | La versión contra la que se informó el error. |
Whiteboard | String | El valor de la |
BlocksAggregate | String | Los ID de errores que son |
CCAggregate | String | Los nombres de inicio de sesión de los usuarios en la lista CC de este error. |
DependsOnAggregate | String | Los ID de errores que este error |
KeywordsAggregate | String | Cada palabra clave que está en este error. |
SeeAlsoAggregate | String | Las URLs en el campo Ver también en el error. |
Comentarios¶
Le permite obtener datos sobre comentarios, dado un ID de error o ID de comentario.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | El ID global único para el comentario. |
BugId | Int | El ID del error sobre el que se encuentra este comentario. |
AttachmentId | Int | Si el comentario se hizo en un archivo adjunto, este será el ID de ese archivo adjunto. En caso contrario será nulo. |
Text | String | El texto real del comentario. |
Count | Int | El número del comentario local al error. La descripción es 0, los comentarios comienzan con 1. |
Creator | String | El nombre de inicio de sesión del autor del comentario. |
CreationTime | Datetime | La hora (en la zona horaria de Bugzilla) en que se agregó el comentario. |
IsPrivate | Boolean | 'verdadero' si este comentario es privado (solo visible para un determinado grupo llamado |
ComentarioEtiquetas¶
Obtenga información sobre las etiquetas configuradas actualmente para un comentario.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Tag | String | La etiqueta de comentario que coincidió con la consultar especificada. |
Query | String | La consultar especificada. |
Tipos de Marcas de Componentes¶
Obtenga información sobre los tipos de marcas de un componente.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | El ID del tipo de bandera. |
FlagName | String | El nombre del tipo de bandera. |
Description | String | La descripción del tipo de bandera. |
CcList | String | La lista CC concatenada para el tipo de indicador, como una sola cadena. |
SortKey | Int | La clave de clasificación del tipo de marca. |
IsActive | Boolean | Si el tipo de indicador está activo o deshabilitado. Las banderas que están en un tipo de bandera deshabilitado no se eliminan. Solo le impide agregarle nuevas banderas. |
IsRequestable | Boolean | Si puede solicitar el tipo de indicador dado (es decir, si el indicador '?' está disponible o no). |
IsRequesteeble | Boolean | Si puedes preguntarle a alguien específicamente o no. |
IsMultiplicable | Boolean | Si puede tener más de un indicador para el tipo de indicador dado en un error/archivo adjunto determinado. |
GrantGroup | Int | El ID de grupo que puede otorgar/denegar indicadores de este tipo. Si el elemento no está incluido, todos los usuarios pueden otorgar/denegar este tipo de indicador. |
RequestGroup | Int | El ID de grupo al que se le permite solicitar el indicador si el indicador es del tipo solicitable. Si el elemento no está incluido, todos los usuarios pueden solicitar este tipo de marca. |
ProductName | String | El producto que contiene el componente en el que se encuentran estos tipos de marcas. |
ComponentName | String | El componente en el que se encuentran estos tipos de indicadores. |
Type | String | Si este tipo de marca pertenece a un 'error' oa un 'archivo adjunto' |
Banderas¶
Obtenga información sobre los indicadores de un archivo adjunto o los indicadores de un error.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | El ID de la bandera. |
Name | String | El nombre de la bandera. |
TypeId | Int | El ID de tipo de la bandera. |
Status | String | El estado actual de la bandera. |
Setter | String | El nombre de inicio de sesión del usuario que creó o modificó por última vez la bandera. |
CreationDate | Datetime | La marca de tiempo cuando se creó originalmente esta bandera. |
ModificationDate | Datetime | La marca de tiempo cuando la bandera fue modificada por última vez. |
BugId | Int | El ID de la bandera. |
AttachmentId | Int | El ID de la bandera. |
Grupos¶
Devuelve información sobre los grupos de Bugzilla.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | El ID entero único que usa Bugzilla para identificar este grupo. Incluso si el nombre del grupo cambia, esta identificación seguirá siendo la misma. |
Name | String | El nombre del grupo. |
Description | String | La descripción del grupo. |
IsBugGroup | Int | Si este grupo se utilizará para informes de errores o solo es específico administrativo. |
UserRegExp | String | Una expresión regular que permite agregar usuarios a este grupo si su inicio de sesión coincide. |
IsActive | Boolean | Si este grupo está actualmente activo o no. |
Membership | Int | Establézcalo en 1 para obtener los usuarios del grupo. Este campo no contiene información. |
Users | String | Objetos de usuario que son miembros de este grupo; solo se devuelve si el usuario establece el parámetro 'Membresía' en 1. |
ProductoComponentes¶
Obtener información sobre los componentes de un producto.
Consultar 'SELECT * FROM ProductComponents' podría ser lento porque recupera todos los ProductID y luego realiza llamadas separadas para cada uno de ellos para obtener los ProductComponents. En ese caso, use el filtrado 'IN' para un mejor rendimiento.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | Un ID entero que identifica de forma única el componente en esta instalación solamente. |
Name | String | El nombre del componente. Este es un identificador único para este componente. |
Description | String | Una descripción del componente, que puede contener HTML. |
DefaulAssignedTo | String | El nombre de inicio de sesión del usuario al que se le asignarán nuevos errores de forma predeterminada. |
DefaultQAContact | String | El nombre de inicio de sesión del usuario que se establecerá como contacto de control de calidad para nuevos errores de forma predeterminada. Cadena vacía si el contacto de control de calidad no está definido. |
SortKey | Int | Los componentes, cuando se muestran en una lista, se ordenan primero por este entero y luego por su nombre. |
IsActive | Boolean | Un valor booleano que indica si el componente está activo. Los componentes inactivos no están habilitados para nuevos errores. |
ProductId | Int | El ID del producto al que pertenece este componente. |
ProductName | String | El nombre del producto al que pertenece este componente. |
Hitos del Producto¶
Obtener información sobre los hitos de un determinado producto.
Consultar 'SELECT * FROM ProductMilestones' podría ser lento porque recupera todos los ProductID y luego realiza llamadas separadas para cada uno de ellos para obtener los ProductMilestones. En ese caso, use el filtrado 'IN' para un mejor rendimiento.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | Un ID entero que identifica de forma única este hito. |
Name | String | El nombre del hito del producto. |
IsActive | Boolean | Un booleano que indica si este hito del producto está activo. |
SortKey | Int | La clave de clasificación de este hito del producto. |
ProductId | Int | El ID del producto al que pertenece este hito. |
ProductName | String | El nombre del producto al que pertenece este hito. |
Productos¶
Enumere los productos disponibles y obtenga información sobre ellos.
De forma predeterminada, esta vista recuperará todos los productos accesibles y seleccionables. Si desea obtener solo los productos contra los que puede ingresar errores, debe usar el filtro 'tipo' como este: type='enterable'
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | Un ID entero que identifica de forma exclusiva el producto en esta instalación únicamente. |
Name [KEY] | String | El nombre del producto. Este es un identificador único para el producto. |
Description | String | Una descripción del producto, que puede contener HTML. |
IsActive | Boolean | Un valor booleano que indica si el producto está activo. |
Classification | String | El nombre de clasificación del producto. |
DefaultMilestone | String | El nombre del hito predeterminado para el producto. |
HasUnconfirmed | Boolean | Indica si el estado de error NO CONFIRMADO está disponible para este producto. |
Type | String | Devolver información sobre tipos específicos de productos como 'accesible', 'seleccionable' o 'modificable' |
Versiones del Producto¶
Le permite obtener información sobre las versiones de un determinado producto.
Consultar 'SELECT * FROM ProductVersions' podría ser lento porque recupera todos los ProductID y luego realiza llamadas separadas para cada uno de ellos para obtener ProductVersions. En ese caso, use el filtrado 'IN' para un mejor rendimiento.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | Un ID entero que identifica de forma única la versión de este producto. |
Name | String | El nombre de la versión del producto. |
IsActive | Boolean | Un valor booleano que indica si esta versión del producto está activa. |
SortKey | Int | La clave de clasificación de esta versión del producto. |
ProductId | Int | El ID del producto al que pertenece esta versión. |
ProductName | String | El nombre del producto al que pertenece esta versión. |
Usuarios¶
Le permite obtener información sobre las cuentas de usuario.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id [KEY] | Int | El ID entero único que usa Bugzilla para representar a este usuario. Incluso si cambia el nombre de inicio de sesión del usuario, esto no cambiará. |
Name | String | El nombre de inicio de sesión del usuario. |
RealName | String | El nombre real del usuario. Puede estar en blanco. |
Email | String | La dirección de correo del usuario. |
CanLogin | Boolean | Un valor booleano para indicar si el usuario puede iniciar sesión en Bugzilla. |
EmailEnabled | Boolean | Un valor booleano para indicar si se enviará al usuario correo relacionado con errores o no. |
LoginDeniedText | String | Un campo de texto que contiene la razón por la que un usuario no puede iniciar sesión en Bugzilla. Si está vacío, la cuenta de usuario está habilitada; de lo contrario, está deshabilitado/cerrado. |
SavedSearches | String | Búsquedas guardadas del usuario. |
SavedReports | String | Informes guardados del usuario. |
Tablas del Sistema¶
Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.
Tablas de Esquema¶
Las siguientes tablas devuelven metadatos de la base de datos para Bugzilla:
- sys_catalogs: enumera las bases de datos disponibles.
- sys_schemas: enumera los esquemas disponibles.
- sys_tablas: enumera las tablas y vistas disponibles.
- sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
- procedimientos_sys: describe los procedimientos almacenados disponibles.
- parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
- sys_keycolumns: describe las claves principal y externa.
- índices_sys: Describe los índices disponibles.
Tablas de Fuentes de Datos¶
Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:
- sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
- sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.
Tablas de Información de Consultas¶
La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:
- identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.
Sys_catalogs¶
Enumera las bases de datos disponibles.
La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:
SELECT * FROM sys_catalogs
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos. |
Sys_schemas¶
Enumera los esquemas disponibles.
La siguiente consultar recupera todos los esquemas disponibles:
SELECT * FROM sys_schemas
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos. |
SchemaName | String | El nombre del esquema. |
Sys_tables¶
Enumera las tablas disponibles.
La siguiente consultar recupera las tablas y vistas disponibles:
SELECT * FROM sys_tables
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | La base de datos que contiene la tabla o vista. |
SchemaName | String | El esquema que contiene la tabla o vista. |
TableName | String | El nombre de la tabla o vista. |
TableType | String | El tipo de tabla (tabla o vista). |
Description | String | Una descripción de la tabla o vista. |
IsUpdateable | Boolean | Si la tabla se puede actualizar. |
Sys_tablecolumns¶
Describe las columnas de las tablas y vistas disponibles.
La siguiente consultar devuelve las columnas y los tipos de datos de la tabla SampleTable_1:
SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='SampleTable_1'
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos que contiene la tabla o vista. |
SchemaName | String | El esquema que contiene la tabla o vista. |
TableName | String | El nombre de la tabla o vista que contiene la columna. |
ColumnName | String | El nombre de la columna. |
DataTypeName | String | El nombre del tipo de datos. |
DataType | Int32 | Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente. |
Length | Int32 | El tamaño de almacenamiento de la columna. |
DisplaySize | Int32 | El ancho máximo normal de la columna designada en caracteres. |
NumericPrecision | Int32 | El número máximo de dígitos en datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora. |
NumericScale | Int32 | La escala de columna o número de dígitos a la derecha del punto decimal. |
IsNullable | Boolean | Si la columna puede contener nulo. |
Description | String | Una breve descripción de la columna. |
Ordinal | Int32 | El número de secuencia de la columna. |
IsAutoIncrement | String | Si el valor de la columna se asigna en incrementos fijos. |
IsGeneratedColumn | String | Si se genera la columna. |
IsHidden | Boolean | Si la columna está oculta. |
IsArray | Boolean | Si la columna es una matriz. |
Sys_procedimientos¶
Enumera los procedimientos almacenados disponibles.
La siguiente consultar recupera los procedimientos almacenados disponibles:
SELECT * FROM sys_procedures
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | La base de datos que contiene el procedimiento almacenado. |
SchemaName | String | El esquema que contiene el procedimiento almacenado. |
ProcedureName | String | El nombre del procedimiento almacenado. |
Description | String | Una descripción del procedimiento almacenado. |
ProcedureType | String | El tipo de procedimiento, como PROCEDIMIENTO o FUNCIÓN. |
Sys_procedureparameters¶
Describe procedimiento almacenado* parámetros.
La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado SampleProcedure:
SELECT * FROM sys_procedureparameters WHERE ProcedureName='SampleProcedure' AND Direction=1 OR Direction=2
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos que contiene el procedimiento almacenado. |
SchemaName | String | El nombre del esquema que contiene el procedimiento almacenado. |
ProcedureName | String | El nombre del procedimiento almacenado* que contiene el parámetro. |
ColumnName | String | El nombre del procedimiento almacenado* parámetro. |
Direction | Int32 | Un número entero correspondiente al tipo de parámetro: entrada (1), entrada/salida (2) o salida (4). Los parámetros de tipo de entrada/salida pueden ser tanto parámetros de entrada como de salida. |
DataTypeName | String | El nombre del tipo de datos. |
DataType | Int32 | Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente. |
Length | Int32 | El número de caracteres permitidos para los datos de caracteres. El número de dígitos permitidos para datos numéricos. |
NumericPrecision | Int32 | La máxima precisión para datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora. |
NumericScale | Int32 | El número de dígitos a la derecha del punto decimal en datos numéricos. |
IsNullable | Boolean | Si el parámetro puede contener nulo. |
IsRequired | Boolean | Si el parámetro es necesario para la ejecución del procedimiento. |
IsArray | Boolean | Si el parámetro es una matriz. |
Description | String | La descripción del parámetro. |
Ordinal | Int32 | El índice del parámetro. |
Sys_keycolumns¶
Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal de la tabla SampleTable_1:
SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='SampleTable_1'
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos que contiene la clave. |
SchemaName | String | El nombre del esquema que contiene la clave. |
TableName | String | El nombre de la tabla que contiene la clave. |
ColumnName | String | El nombre de la columna clave. |
IsKey | Boolean | Si la columna es una clave principal en la tabla a la que se hace referencia en el campo TableName. |
IsForeignKey | Boolean | Si la columna es una clave externa a la que se hace referencia en el campo TableName. |
PrimaryKeyName | String | El nombre de la clave principal. |
ForeignKeyName | String | El nombre de la clave foránea. |
ReferencedCatalogName | String | La base de datos que contiene la clave principal. |
ReferencedSchemaName | String | El esquema que contiene la clave principal. |
ReferencedTableName | String | La tabla que contiene la clave principal. |
ReferencedColumnName | String | El nombre de la columna de la clave principal. |
Sys_foreignkeys¶
Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:
SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos que contiene la clave. |
SchemaName | String | El nombre del esquema que contiene la clave. |
TableName | String | El nombre de la tabla que contiene la clave. |
ColumnName | String | El nombre de la columna clave. |
PrimaryKeyName | String | El nombre de la clave principal. |
ForeignKeyName | String | El nombre de la clave foránea. |
ReferencedCatalogName | String | La base de datos que contiene la clave principal. |
ReferencedSchemaName | String | El esquema que contiene la clave principal. |
ReferencedTableName | String | La tabla que contiene la clave principal. |
ReferencedColumnName | String | El nombre de la columna de la clave principal. |
ForeignKeyType | String | Designa si la clave externa es una clave de importación (apunta a otras tablas) o de exportación (hace referencia desde otras tablas). |
Sys_indexes¶
Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.
La siguiente consultar recupera todos los índices que no son claves principales:
SELECT * FROM sys_indexes WHERE IsPrimary='false'
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos que contiene el índice. |
SchemaName | String | El nombre del esquema que contiene el índice. |
TableName | String | El nombre de la tabla que contiene el índice. |
IndexName | String | El nombre del índice. |
ColumnName | String | El nombre de la columna asociada con el índice. |
IsUnique | Boolean | True si el índice es único. Falso en caso contrario. |
IsPrimary | Boolean | True si el índice es una clave principal. Falso en caso contrario. |
Type | Int16 | Un valor entero correspondiente al tipo de índice: estadística (0), agrupado (1), hash (2) u otro (3). |
SortOrder | String | El orden de clasificación: A para ascender o D para descender. |
OrdinalPosition | Int16 | El número de secuencia de la columna en el índice. |
Sys_connection_props¶
Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.
Al consultar esta tabla, se debe usar la cadena de conexión de configuración:
jdbc:cdata:bugzilla:config:
Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.
La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:
SELECT * FROM sys_connection_props WHERE Value <> ''
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Name | String | El nombre de la propiedad de conexión. |
ShortDescription | String | Una breve descripción. |
Type | String | El tipo de datos de la propiedad de conexión. |
Default | String | El valor predeterminado si no se establece uno explícitamente. |
Values | String | Una lista separada por comas de valores posibles. Se lanza un error de validación si se especifica otro valor. |
Value | String | El valor que establezca o un valor predeterminado preconfigurado. |
Required | Boolean | Si la propiedad es necesaria para conectarse. |
Category | String | La categoría de la propiedad de conexión. |
IsSessionProperty | String | Si la propiedad es una propiedad de sesión, utilizada para guardar información sobre la conexión actual. |
Sensitivity | String | El nivel de sensibilidad de la propiedad. Esto informa si la propiedad está ofuscada en los formularios de registro y autenticación. |
PropertyName | String | Una forma truncada en mayúsculas y minúsculas del nombre de la propiedad de conexión. |
Ordinal | Int32 | El índice del parámetro. |
CatOrdinal | Int32 | El índice de la categoría de parámetro. |
Hierarchy | String | Muestra las propiedades dependientes asociadas que deben configurarse junto con esta. |
Visible | Boolean | Informa si la propiedad está visible en la interfaz de usuario de la conexión. |
ETC | String | Diversa información miscelánea sobre la propiedad. |
Sys_sqlinfo¶
Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.
Procesamiento Colaborativo de Consultas¶
Al trabajar con fuentes de datos que no admiten SQL-92, puede consultar la vista sys_sqlinfo para determinar las capacidades de consultar de las APIs subyacentes, expresadas en sintaxis SQL. El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT al servidor y luego procesa el resto de la consultar en la memoria.
Descubrimiento de las Capacidades SELECT de la Fuente de Datos¶
A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.
Nombre | Descripción | Valores posibles |
---|---|---|
AGGREGATE_FUNCTIONS | Funciones de agregación admitidas. | AVG , COUNT , MAX , MIN , SUM , DISTINCT |
COUNT | Si se admite la función COUNT. | YES , NO |
IDENTIFIER_QUOTE_OPEN_CHAR | El carácter de apertura utilizado para escapar de un identificador. | [ |
IDENTIFIER_QUOTE_CLOSE_CHAR | El carácter de cierre utilizado para escapar de un identificador. | ] |
SUPPORTED_OPERATORS | Una lista de operadores de SQL admitidos. | = , > , < , >= , <= , <> , != , LIKE , NOT LIKE , IN , NOT IN , IS NULL , IS NOT NULL , AND , OR |
GROUP_BY | Si se admite GROUP BY y, de ser así, el grado de compatibilidad. | NO , NO_RELATION , EQUALS_SELECT , SQL_GB_COLLATE |
STRING_FUNCTIONS | Funciones de cadena admitidas. | 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 | Funciones numéricas compatibles. | 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 | Funciones de fecha/hora admitidas. | 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 tablas omitidas durante la replicación. | |
REPLICATION_TIMECHECK_COLUMNS | Una matriz de cadenas que contiene una lista de columnas que se usarán para verificar (en el orden dado) para usar como una columna modificada durante la replicación. | |
IDENTIFIER_PATTERN | Valor de cadena que indica qué cadena es válida para un identificador. | |
SUPPORT_TRANSACTION | Indica si el proveedor admite transacciones como compromiso y reversión. | YES , NO |
DIALECT | Indica el dialecto SQL a usar. | |
KEY_PROPERTIES | Indica las propiedades que identifican la base de datos uniforme. | |
SUPPORTS_MULTIPLE_SCHEMAS | Indica si pueden existir varios esquemas para el proveedor. | YES , NO |
SUPPORTS_MULTIPLE_CATALOGS | Indica si pueden existir varios catálogos para el proveedor. | YES , NO |
DATASYNCVERSION | La versión de sincronización de datos necesaria para acceder a este controlador. | Standard , Starter , Professional , Enterprise |
DATASYNCCATEGORY | La categoría Sincronización de datos de este controlador. | Source , Destination , Cloud Destination |
SUPPORTSENHANCEDSQL | Si se admite la funcionalidad de SQL mejorada más allá de lo que ofrece la API. | TRUE , FALSE |
SUPPORTS_BATCH_OPERATIONS | Si se admiten las operaciones lote. | YES , NO |
SQL_CAP | Todas las funciones de SQL admitidas para este controlador. | 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 | Un valor de cadena especifica las cacheOptions preferidas. | |
ENABLE_EF_ADVANCED_QUERY | Indica si el controlador admite directamente consultas avanzadas provenientes de Entity Framework. De lo contrario, las consultas se manejarán del lado del cliente. | YES , NO |
PSEUDO_COLUMNS | Una matriz de cadenas que indica las pseudocolumnas disponibles. | |
MERGE_ALWAYS | Si el valor es verdadero, el modo de combinación se ejecuta a la fuerza en la sincronización de datos. | TRUE , FALSE |
REPLICATION_MIN_DATE_QUERY | Una consultar de selección para devolver la fecha y hora de inicio de la réplica. | |
REPLICATION_MIN_FUNCTION | Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un min del lado del servidor. | |
REPLICATION_START_DATE | Permite que un proveedor especifique una fecha de inicio de réplica. | |
REPLICATION_MAX_DATE_QUERY | Una consultar de selección para devolver la fecha y hora de finalización de la réplica. | |
REPLICATION_MAX_FUNCTION | Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un máx. del lado del servidor. | |
IGNORE_INTERVALS_ON_INITIAL_REPLICATE | Una lista de tablas que omitirán dividir la réplica en fragmentos en la réplica inicial. | |
CHECKCACHE_USE_PARENTID | Indica si la instrucción CheckCache debe realizarse en la columna de clave principal. | TRUE , FALSE |
CREATE_SCHEMA_PROCEDURES | Indica procedimientos almacenados* que se puede utilizar para generar archivos de esquema. |
La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:
SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'
Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte el Modelo de datos para obtener más información.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
NAME | String | Un componente de la sintaxis SQL o una capacidad que se puede procesar en el servidor. |
VALUE | String | Detalles sobre el SQL o la sintaxis de SQL admitidos. |
Sys_identidad¶
Devuelve información sobre los intentos de modificación.
La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:
SELECT * FROM sys_identity
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id | String | El ID generado por la base de datos devuelto de una operación de modificación de datos. |
Batch | String | Un identificador para el lote. 1 para una sola operación. |
Operation | String | El resultado de la operación en el lote: INSERTADO, ACTUALIZADO o ELIMINADO. |
Message | String | ÉXITO o un mensaje de error si falla la actualización en el lote. |
Propiedades de Configuraciones Avanzadas¶
Las propiedades de configuraciones avanzadas son las diversas opciones que se pueden utilizar para establecer una conexión. Esta sección proporciona una lista completa de las opciones que puede configurar. Haga clic en los enlaces para obtener más detalles.
Propiedad | Descripción |
---|---|
URL | La URL del servidor Bugzilla utilizado para iniciar sesión. |
APIKey | Una ApiKey para autenticarse en su cuenta. Las claves API se pueden crear en Preferencias > Sección de claves API. |
Propiedad | Descripción |
---|---|
SSLServerCert | El certificado que se aceptará del servidor al conectarse mediante TLS/SSL. |
Propiedad | Descripción |
---|---|
Location | Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados. |
BrowsableSchemas | Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC. |
Views | Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC. |
Propiedad | Descripción |
---|---|
IncludeCustomFields | Determina si los campos personalizados deben incluirse como columnas de la tabla o no. |
MaxRows | Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño. |
Other | Estas propiedades ocultas se usan solo en casos de uso específicos. |
Pagesize | El número máximo de resultados a devolver por página de Bugzilla. |
PseudoColumns | Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla. |
RowScanDepth | El número máximo de filas para escanear para buscar las columnas disponibles en una tabla. |
Timeout | El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación. |
Autenticación¶
Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.
Propiedad | Descripción |
---|---|
URL | La URL del servidor Bugzilla utilizado para iniciar sesión. |
APIKey | Una ApiKey para autenticarse en su cuenta. Las claves API se pueden crear en Preferencias > Sección de claves API. |
URL¶
La URL del servidor Bugzilla utilizado para iniciar sesión.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
La URL del servidor Bugzilla utilizado para iniciar sesión.
Clave API¶
Una ApiKey para autenticarse en su cuenta. Las claves API se pueden crear en Preferencias > Sección de claves API.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Clave API
SSL¶
Esta sección proporciona una lista completa de las propiedades SSL que puede configurar.
Propiedad | Descripción |
---|---|
SSLServerCert | El certificado que se aceptará del servidor al conectarse mediante TLS/SSL. |
SSLServerCert¶
El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Si usa una conexión TLS/SSL, esta propiedad se puede usar para especificar el certificado TLS/SSL que se aceptará del servidor. Se rechaza cualquier otro certificado que no sea de confianza para la máquina.
Esta propiedad puede tomar las siguientes formas:
Descripción | Ejemplo |
---|---|
Un certificado PEM completo (ejemplo abreviado por brevedad) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
Una ruta a un archivo local que contiene el certificado | C:\cert.cer |
La clave pública (ejemplo abreviado por brevedad) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
La huella digital MD5 (los valores hexadecimales también pueden estar separados por espacios o dos puntos) | ecadbdda5a1529c58a1e9e09828d70e4 |
La huella digital SHA1 (los valores hexadecimales también pueden estar separados por espacios o dos puntos) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
Si no se especifica, se acepta cualquier certificado en el que confíe la máquina.
La máquina valida los certificados como confiables según el almacén de confianza del sistema. El almacén de confianza utilizado es el valor 'javax.net.ssl.trustStore' especificado para el sistema. Si no se especifica ningún valor para esta propiedad, se utiliza el almacén de confianza predeterminado de Java (por ejemplo, JAVA_HOME\lib\security\cacerts).
Use '*' para indicar que acepta todos los certificados. Tenga en cuenta que esto no se recomienda debido a problemas de seguridad.
Esquema¶
Esta sección proporciona una lista completa de propiedades de esquema que puede configurar.
Propiedad | Descripción |
---|---|
Location | Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados. |
BrowsableSchemas | Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC. |
Views | Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC. |
Ubicación¶
Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.
Tipo de Datos¶
string
Valor por Defecto¶
"%APPDATA%\\\Bugzilla Data Provider\\Schema"
Observaciones¶
La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location
La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.
Si no se especifica, la ubicación predeterminada es "%APPDATA%\\ Bugzilla Data Provider\Schema" con %APPDATA%
estando configurado en el directorio de configuración del usuario:
Plataforma | %APPDATA% |
---|---|
Windows | El valor de la variable de ambiente APPDATA |
Mac | ~/Biblioteca/Soporte de aplicaciones |
Linux | ~/.config |
Esquemas Navegables¶
Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.
Mesas¶
Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Listar las tablas de algunas bases de datos puede resultar costoso. Proporcionar una lista de tablas en la cadena de conexión mejora el rendimiento del conector.
Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.
Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.
Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.
Puntos de Vista¶
Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.
Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.
Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.
Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.
Misceláneas¶
Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.
Propiedad | Descripción |
---|---|
IncludeCustomFields | Determina si los campos personalizados deben incluirse como columnas de la tabla o no. |
MaxRows | Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño. |
Other | Estas propiedades ocultas se usan solo en casos de uso específicos. |
Pagesize | El número máximo de resultados a devolver por página de Bugzilla. |
PseudoColumns | Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla. |
RowScanDepth | El número máximo de filas para escanear para buscar las columnas disponibles en una tabla. |
Timeout | El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación. |
Incluir Campos Personalizados¶
Determina si los campos personalizados deben incluirse como columnas de la tabla o no.
Tipo de Datos¶
string
Valor por Defecto¶
"false"
Observaciones¶
Es posible crear campos personalizados en Bugzilla. Para recuperar sus valores, puede establecer IncludeCustomFields=true como propiedad de conexión. Al hacerlo, aparecerá una lista de los campos personalizados creados como columnas de la tabla.
Filas Máximas¶
Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Tipo de Datos¶
int
Valor por Defecto¶
-1
Observaciones¶
Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Otro¶
Estas propiedades ocultas se usan solo en casos de uso específicos.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.
Especifique varias propiedades en una lista separada por punto y coma.
Integración y Formateo¶
Propiedad | Descripción |
---|---|
DefaultColumnSize | Establece la longitud predeterminada de los campos de cadena cuando la fuente de datos no proporciona la longitud de columna en los metadatos. El valor predeterminado es 2000. |
ConvertDateTimeToGMT | Determina si se convierten los valores de fecha y hora a GMT, en lugar de la hora local de la máquina. |
RecordToFile=filename | Registra la transferencia de datos del socket subyacente al archivo especificado. |
Tamaño de Página¶
El número máximo de resultados a devolver por página de Bugzilla.
Tipo de Datos¶
int
Valor por Defecto¶
-1
Observaciones¶
El Pagesize
la propiedad afecta el número máximo de resultados a devolver por página de Bugzilla. Establecer un valor más alto puede resultar en un mejor rendimiento a costa de memoria adicional asignada por página consumida.
Pseudocolumnas¶
Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".
FilaExploraciónProfundidad¶
El número máximo de filas para escanear para buscar las columnas disponibles en una tabla.
Tipo de Datos¶
int
Valor por Defecto¶
40
Observaciones¶
Las columnas de una tabla deben determinarse escaneando las filas de la tabla. Este valor determina el número máximo de filas que se escanearán.
Establecer un valor alto puede disminuir el rendimiento. Establecer un valor bajo puede evitar que el tipo de datos se determine correctamente, especialmente cuando hay datos nulos.
Se Acabó el Tiempo¶
El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.
Tipo de Datos¶
int
Valor por Defecto¶
60
Observaciones¶
Si Timeout
= 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.
Si Timeout
caduca y la operación aún no se ha completado, el conector genera una excepción.