Detalles de Conexión del Google Data Catalog¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 21.0.8361 del conector.

Empezando¶

Compatibilidad con la versión del Google Data Catalog

El conector aprovecha la API de GoogleDataCatalog para habilitar el acceso de solo lectura a GoogleDataCatalog.

Establecer una Conexión¶

Conexión al Google Data Catalog¶

Proporcione las siguientes propiedades de conexión antes de agregar las propiedades de autenticación.

• OrganizationId: el ID asociado con el recurso de la organización de Google Cloud Platform al que desea conectarse. Encuéntrelo navegando a la consola en la nube.
  Haga clic en el menú desplegable de selección de proyectos y seleccione su organización de la lista. Luego, haga clic en More -> Settings. El ID de la organización se muestra en esta página.
• ProjectId El ID asociado con el recurso del proyecto de Google Cloud Platform al que te gustaría conectarte.
  Encuentre esto navegando al tablero de la consola en la nube y seleccionando su proyecto de Select from desplegable. El ID del proyecto estará presente en Project info tarjeta.

Autenticación en el Google Data Catalog¶

Todas las conexiones al Google Data Catalog se autentican mediante OAuth. El conector admite el uso de cuentas de usuario, cuentas de servicio y cuentas de instancias de GCP para la autenticación.

Autenticarse con una Cuenta de Usuario¶

AuthScheme debe establecerse en OAuth en todos los flujos de cuentas de usuario. Para las aplicaciones de escritorio, la aplicación predeterminada del conector es la forma más sencilla de autenticación. El único requisito adicional es establecer InitiateOAuth a GETANDREFRESH.

Cuando se inicie el controlador, se abrirá un navegador y Google Data Catalog solicitará su información de inicio de sesión. El conector utilizará las credenciales que proporcione para acceder a sus datos del Google Data Catalog. Estas credenciales se guardarán y actualizarán automáticamente según sea necesario.

Consulte Uso de la autenticación OAuth para obtener una guía de autenticación que cubra todos los métodos admitidos en detalle.

Autenticarse con una Cuenta de Servicio¶

Para autenticarse usando una cuenta de servicio, debe crear una nueva cuenta de servicio y tener una copia del certificado de la cuenta.

Para un archivo JSON, deberá establecer estas propiedades:

• AuthScheme: Requerido. Establézcalo en OAuthJWT.
• InitiateOAuth: Requerido. Establézcalo en GETANDREFRESH.
• OAuthJWTCertType: Requerido. Establézcalo en GOOGLEJSON.
• OAuthJWTCert: Requerido. Establézcalo en la ruta del archivo .json proporcionado por Google.
• OAuthJWTSubject: Opcional. Establezca este valor solo si la cuenta de servicio es parte de un dominio de GSuite y desea habilitar la delegación. El valor de esta propiedad debe ser la dirección de correo del usuario a cuyos datos desea acceder.

Para un archivo PFX, deberá establecer estas propiedades en su lugar:

• AuthScheme: Requerido. Establézcalo en OAuthJWT.
• InitiateOAuth: Requerido. Establézcalo en GETANDREFRESH.
• OAuthJWTCertType: Requerido. Establézcalo en PFXFILE.
• OAuthJWTCert: Requerido. Establézcalo en la ruta del archivo .pfx proporcionado por Google.
• OAuthJWTCertPassword: Opcional. Establézcalo en la contraseña del archivo .pfx. En la mayoría de los casos, será necesario proporcionarlo, ya que Google cifra los certificados PFX.
• OAuthJWTCertSubject: Opcional. Configure esto solo si está usando un OAuthJWTCertType que almacena múltiples certificados. No debe configurarse para certificados PFX generados por Google.
• OAuthJWTIssuer: Requerido. Establézcalo en la dirección de correo de la cuenta de servicio. Esta dirección generalmente incluirá el dominio iam.gserviceaccount.com.
• OAuthJWTSubject: Opcional. Establezca este valor solo si la cuenta de servicio es parte de un dominio de GSuite y desea habilitar la delegación. El valor de esta propiedad debe ser la dirección de correo del usuario a cuyos datos desea acceder.

Si aún no tiene una cuenta de servicio, puede crear una siguiendo el procedimiento en Crear una aplicación OAuth personalizada.

Autenticarse con una Cuenta de Instancia de GCP¶

Cuando se ejecuta en una máquina virtual de GCP, el conector puede autenticarse mediante una cuenta de servicio vinculada a la máquina virtual. Para usar este modo, configure AuthScheme a GCPInstanceAccount.

Uso de la Autenticación OAuth¶

Utilice el estándar de autenticación OAuth para conectarse al Google Data Catalog. Puede autenticarse con una cuenta de usuario o una cuenta de servicio. El conector facilita esto como se describe a continuación.

Uso de una Cuenta de Usuario para Autenticarse en el Google Data Catalog¶

El flujo de la cuenta de usuario requiere que el usuario que se autentica interactúe con Google Data Catalog a través del navegador.

Credenciales Integradas¶

Consulte Credenciales integradas para conectarse con las credenciales incrustadas del conector y omitir la creación de una aplicación OAuth personalizada.

Credenciales Personalizadas¶

En lugar de conectarse con las credenciales integradas del conector, puede registrar una aplicación para obtener OAuthClientId y OAuthClientSecret.

Cuándo Crear una Aplicación OAuth Personalizada¶

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado en Google Data Catalog y puede conectarse con sus credenciales integradas. Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth del Google Data Catalog para otorgar permisos al conector.

Uso de una Cuenta de Servicio para Conectarse al Google Data Catalog¶

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador. También puede usar una cuenta de servicio para delegar ámbitos de acceso de toda la empresa al conector.

Debe crear una aplicación OAuth en este flujo. A continuación, puede conectarse a los datos del Google Data Catalog a los que la cuenta de servicio tiene permiso para acceder. Consulte Credenciales personalizadas para obtener una guía de autenticación.

Creación de una Aplicación OAuth Personalizada¶

Consulte Crear una aplicación OAuth personalizada para un procedimiento.

Credenciales Integradas¶

Autenticarse con las Credenciales de OAuth Integradas¶

Autenticación de Escritorio con la Aplicación OAuth Integrada¶

Puede conectarse sin configurar ninguna propiedad de conexión para sus credenciales de usuario. Después de configurar lo siguiente, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth.

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el antiguo.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Credenciales Personalizadas¶

Autenticación de Escritorio con Su Aplicación OAuth¶

Siga los pasos a continuación para autenticarse con las credenciales de una aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada.

Obtenga un Token de Acceso OAuth¶

Después de configurar lo siguiente, está listo para conectarse:

• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• CallbackURL: establezca esto en la URL de redireccionamiento en la configuración de su aplicación.
• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken..

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el antiguo.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Máquinas Sin Cabeza¶

Uso de OAuth en una Máquina Sin Cabeza¶

Para crear fuentes de datos de Google Data Catalog en servidores autónomos u otras máquinas en las que el conector no puede abrir un navegador, debe autenticarse desde otra máquina. La autenticación es un proceso de dos pasos.

1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Uso de las Credenciales para una Aplicación OAuth Personalizada¶

Cree una aplicación OAuth personalizada

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Luego puede seguir los procedimientos a continuación para autenticarse y conectarse a los datos.

Obtenga un código verificador

Establezca las siguientes propiedades en la máquina sin periféricos:

• InitiateOAuth: Ajústelo a APAGADO.
• OAuthClientId: establezca esto en la ID de la aplicación en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto de la aplicación en la configuración de su aplicación.

Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión.

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthVerifier: Establézcalo en el código del verificador.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Conectarse a datos

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• CallbackURL: establezca esto en la URL de devolución de llamada en la configuración de su aplicación.

Pruebe la conexión para autenticarse. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.

Creación de una Aplicación OAuth Personalizada¶

Puede usar una aplicación OAuth personalizada para autenticar una cuenta de servicio o una cuenta de usuario.

Cree una Aplicación OAuth para la Autenticación de Cuentas de Usuario¶

Siga el procedimiento a continuación para registrar una aplicación y obtener el OAuthClientId y OAuthClientSecret.

Crear una Aplicación OAuth Personalizada: Escritorio¶

1. Inicie sesión en la Consola API de Google y abra un proyecto. Seleccione el API Manager en el menú principal.
2. En el flujo de consentimiento del usuario, haga clic en Credenciales -> Crear credenciales -> ID de cliente de OAuth. Haz clic en Otro. Después de crear la aplicación, OAuthClientId y OAuthClientSecret son mostrados.
3. Haga clic en Biblioteca -> API del catálogo de datos de Google Cloud -> Habilitar API.
4. Después de retroceder un paso: haga clic en Biblioteca -> API del catálogo de datos de Google Cloud -> Habilitar API.

Cree una Aplicación OAuth para la Autenticación de Cuentas de Servicio¶

Siga los pasos a continuación para crear una aplicación OAuth y generar una clave privada. A continuación, autorizará la cuenta de servicio.

1. Inicie sesión en la Consola API de Google y abra un proyecto. Seleccione el API Manager en el menú principal.
2. Haga clic en Crear credenciales -> Clave de cuenta de servicio.
3. En el menú Cuenta de servicio, seleccione Nueva cuenta de servicio o seleccione una cuenta de servicio existente.
4. Si está creando una nueva cuenta de servicio, seleccione además uno o más roles. Puede asignar roles primitivos a nivel de proyecto en la sección IAM y Admin; otras funciones le permiten personalizar aún más el acceso a las APIs de Google.
5. En la sección Tipo de clave, seleccione el tipo de clave P12.
6. Cree la aplicación para descargar el par de claves. Se muestra la contraseña de la clave privada: Configure esto en OAuthJWTCertPassword.
7. En la sección de cuentas de servicio, haga clic en Administrar cuentas de servicio y configure OAuthJWTIssuer a la dirección de correo que se muestra en el campo ID de la cuenta de servicio.
8. Haga clic en Biblioteca -> API del catálogo de datos de Google Cloud -> Habilitar API.

Notas Importantes¶

Procedimientos Almacenados¶

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas¶

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas¶

En esta sección se detalla una selección de funciones avanzadas del conector del Google Data Catalog.

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 el Google Data Catalog 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 Usando 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 Schemas 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¶

Descripción general

Esta sección muestra los objetos API disponibles y proporciona más información sobre cómo ejecutar SQL en las APIs del Google Data Catalog.

Características clave

• El conector modela entidades del Google Data Catalog como documentos, carpetas y grupos como vistas relacionales, lo que le permite escribir SQL para consultar los datos del Google Data Catalog.
• Procedimientos almacenados* le permiten ejecutar operaciones en Google Data Catalog
• La conectividad en vivo con estos objetos significa que cualquier cambio en su cuenta del Google Data Catalog se refleja de inmediato al usar el conector.

Puntos de vista

Puntos de vista describe las vistas disponibles. Las vistas se definen estáticamente para modelar entidades de solo lectura, como esquemas, tablas y plantillas de etiquetas.

Procedimientos almacenados

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para Google Data Catalog. Procedimientos almacenados* le permiten ejecutar operaciones en Google Data Catalog, incluida la descarga de documentos y el movimiento de sobres.

Procesamiento colaborativo de consultas

El conector descarga la mayor cantidad posible del procesamiento de la instrucción SELECT en Google Data Catalog y luego procesa el resto de la consultar en la memoria. Las limitaciones y los requisitos de la API también se documentan en esta sección.

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 del Google Data Catalog¶

Esquemas¶

Para ver la lista de esquemas

Información Específica de la Tabla¶

Seleccionar¶

El conector utilizará la API del Google Data Catalog para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• DataSetName admite la comparación 'CONTIENE'.
• Type admite la comparación '='.
• ProjectId admite la comparación '='.
• EntryGroup admite la comparación '='.
• CreatedTime admite las comparaciones '=, <, <=, >, >='.
• UpdatedTime admite las comparaciones '=, <, <=, >, >='.
• OrganizationId admite la comparación '='.
• DisplayName admite la comparación 'CONTIENE'.
• Description admite la comparación '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

SELECT * FROM Schemas WHERE CONTAINS (DataSetName, 'prop')

SELECT * FROM Schemas WHERE UpdatedTime >= '2018-01-01 01:00:00'

SELECT * FROM Schemas WHERE CreatedTime < '2018-06-01'

SELECT * FROM Schemas WHERE UpdatedTime > '2018-06-01 12:00:00' AND CreatedTime <= '2019-06-01 11:00'

SELECT * FROM Schemas WHERE OrganizationId = '112025358'

SELECT * FROM Schemas WHERE ProjectId = 'bigquery-public-data OR ProjectId = 'level-works-253411''

Además, las columnas LastAccessedTime y UpdatedTime se pueden usar en la cláusula ORDER BY, de la siguiente manera:

SELECT * FROM Schemas ORDER BY LastAccessed ASC

SELECT * FROM Schemas ORDER BY UpdatedTime DESC

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

TablaColumnas¶

Para ver las columnas de la tabla o ver

Información Específica de la Tabla¶

Seleccionar¶

El conector utilizará la API del Google Data Catalog para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. Se requiere ResourceName para realizar una solicitud y el resto del filtro se ejecuta en el lado del cliente dentro del conector.

• ResourceName admite la comparación '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

SELECT * FROM TableColumns WHERE ResourceName = 'projects/bigquery-public-data/locations/US/entryGroups/@bigquery/entries/cHJvamVjdHMvYmlncXVlcnktcHVibGljLWRhdGEvZGF0YXNldHMvZ2VvX2NlbnN1c19ibG9ja2dyb3Vwcy90YWJsZXMvYmxvY2tncm91cHNfMTE'

Columnas¶

TablaPropiedades¶

Para ver las propiedades de la tabla

Información Específica de la Tabla¶

Seleccionar¶

El conector utilizará la API del Google Data Catalog para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. Se requiere ResourceName para realizar una solicitud y el resto del filtro se ejecuta en el lado del cliente dentro del conector.

• ResourceName admite la comparación '='.

SELECT * FROM TableProperties WHERE ResourceName = 'projects/bigquery-public-data/locations/US/entryGroups/@bigquery/entries/cHJvamVjdHMvYmlncXVlcnktcHVibGljLWRhdGEvZGF0YXNldHMvZ2VvX2NlbnN1c19ibG9ja2dyb3Vwcy90YWJsZXMvYmxvY2tncm91cHNfMTE'

Columnas¶

Mesas¶

Para ver la lista de tablas y vistas

Información Específica de la Tabla¶

Seleccionar¶

El conector utilizará la API del Google Data Catalog para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• DataSetName admite la comparación 'CONTIENE'.
• Type admite la comparación '='.
• ProjectId admite la comparación '='.
• EntryGroup admite la comparación '='.
• CreatedTime admite las comparaciones '=, <, <=, >, >='.
• UpdatedTime admite las comparaciones '=, <, <=, >, >='.
• OrganizationId admite la comparación '='.
• TagName admite la comparación 'CONTIENE'.
• DisplayName admite la comparación 'CONTIENE'.
• SearchColumn admite la comparación 'CONTIENE'.
• Description admite la comparación '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

SELECT * FROM Tables WHERE UpdatedTime <= '2018-06-01 11:00:00.0'

SELECT * FROM Tables WHERE UpdatedTime >= '2018-06-01'

SELECT * FROM Tables WHERE UpdatedTime > '2018-06-01 12:00:00' AND CreatedTime < '2019-06-01 11:00:00'

SELECT * FROM Tables WHERE OrganizationId = '112025358'

SELECT * FROM Tables WHERE ProjectId = 'bigquery-public-data'

SELECT * FROM Tables WHERE CONTAINS (SearchColumn, 'name')

SELECT * FROM Tables WHERE TagName = 'test'

SELECT * FROM Tables WHERE Type = 'table' OR Type = 'view'

Además, las columnas LastAccessedTime y UpdatedTime se pueden usar en la cláusula ORDER BY, de la siguiente manera:

SELECT * FROM Tables ORDER BY LastAccessed DESC

SELECT * FROM Tables ORDER BY UpdatedTime ASC

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

TablaEtiquetasDetalles¶

Para ver la lista de etiquetas añadidas a la tabla

Información Específica de la Tabla¶

Seleccionar¶

El conector utilizará la API del Google Data Catalog para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. Se requiere ResourceName para realizar una solicitud y el resto del filtro se ejecuta en el lado del cliente dentro del conector.

• ResourceName admite la comparación '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

SELECT * FROM TableTagsDetails WHERE ResourceName = 'projects/level-works-253411/locations/us/entryGroups/@bigquery/entries/cHJvamVjdHMvbGV2ZWwtd29ya3MtMjUzNDExL2RhdGFzZXRzL3Rlc3RkYi90YWJsZXMvbXl2aWV3'

Columnas¶

EtiquetaPlantillaColumnas¶

Para ver la lista de columnas en TagTemplate.

Información Específica de la Tabla¶

Seleccionar¶

El conector utilizará la API del Google Data Catalog para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. Se requiere ResourceName para realizar una solicitud y el resto del filtro se ejecuta en el lado del cliente dentro del conector.

• ResourceName admite la comparación '='.

SELECT * FROM TagTemplateColumns WHERE ResourceName = 'projects/level-works-253411/locations/us-central1/tagTemplates/demotemplate'

Columnas¶

TagTemplateIAMPolicy¶

Para ver el permiso TagTemplates en el proyecto

Información Específica de la Tabla¶

Seleccionar¶

El conector utilizará la API del Google Data Catalog para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. Se requiere ResourceName para realizar una solicitud y el resto del filtro se ejecuta en el lado del cliente dentro del conector.

• ResourceName admite la comparación '='.

SELECT * FROM TagTemplateIAMPolicy WHERE ResourceName = 'projects/level-works-253411/locations/us-central1/tagTemplates/demotemplate'

Columnas¶

Plantillas de Etiquetas¶

Para ver la lista de TagTemplates en el proyecto

Información Específica de la Tabla¶

Seleccionar¶

El conector utilizará la API del Google Data Catalog para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Name admite la comparación 'CONTIENE'.
• Type admite la comparación '='.
• ProjectId admite la comparación '='.
• CreatedTime admite las comparaciones '=, <, <=, >, >='.
• UpdatedTime admite las comparaciones '=, <, <=, >, >='.
• OrganizationId admite la comparación '='.
• DisplayName admite la comparación 'CONTIENE'.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

SELECT * FROM TagTemplates WHERE OrganizationId = '112025358'

SELECT * FROM TagTemplates WHERE CONTAINS (Name, 'test') OR ProjectId = 'bigquery-public-data'

SELECT * FROM TagTemplates WHERE CreatedTime >= '2018-01-01 01:00:00'

SELECT * FROM TagTemplates WHERE UpdatedTime < '2018-06-01'

SELECT * FROM TagTemplates WHERE UpdatedTime > '2018-06-01 12:00:00' AND CreatedTime <= '2019-06-01 11:00'

SELECT * FROM TagTemplates WHERE Type = 'tag_template' AND DisplayName = 'test_template'

Además, las columnas LastAccessedTime y UpdatedTime se pueden usar en la cláusula ORDER BY, de la siguiente manera:

SELECT * FROM TagTemplates ORDER BY LastAccessed ASC

SELECT * FROM TagTemplates ORDER BY UpdatedTime DESC

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Procedimientos Almacenados¶

Procedimientos almacenados* están disponibles para complementar los datos disponibles del Modelo de datos. Puede ser necesario actualizar los datos disponibles desde una vista usando un procedimiento almacenado* porque los datos no proporcionan actualizaciones bidireccionales directas, similares a tablas. En estas situaciones, la recuperación de los datos se realiza utilizando la vista o tabla adecuada, mientras que la actualización se realiza llamando a un procedimiento almacenado. Procedimientos almacenados* toman una lista de parámetros y devuelven un conjunto de datos que contiene la colección de tuplas que constituyen la respuesta.

Jitterbit Connector para Procedimientos Almacenados del Google Data Catalog¶

Obtener Token de Acceso de OAuth¶

Obtiene el token de acceso de OAuth que se utilizará para la autenticación con varios servicios de Google.

Aporte¶

Columnas del Conjunto de Resultados¶

Obtener URL de Autorización de OAuth¶

Obtiene la URL de autorización de OAuth para la autenticación con varios servicios de Google.

Aporte¶

Columnas del Conjunto de Resultados¶

RefreshOAuthAccessToken¶

Obtiene el token de acceso de OAuth que se utilizará para la autenticación con varios servicios de Google.

Aporte¶

Columnas del Conjunto de Resultados¶

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 el Google Data Catalog:

• 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 Consulta¶

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¶

Sys_schemas¶

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas¶

Sys_tables¶

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas¶

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 Esquemas:

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

Columnas¶

Sys_procedimientos¶

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures

Columnas¶

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¶

Sys_keycolumns¶

Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal de la tabla Schemas:

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

Columnas¶

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¶

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¶

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:googledatacatalog: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¶

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.

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¶

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¶

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.

Autenticación

OAuth

JWT OAuth

SSL

Esquema

Misceláneas

Autenticación¶

Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.

AuthScheme¶

El tipo de autenticación que se utilizará al conectarse al Google Data Catalog.

Valores Posibles¶

Auto, OAuth, OAuthJWT, GCPInstanceAccount

Tipo de Datos¶

string

Valor por Defecto¶

"Auto"

Observaciones¶

• Automático: permite que el controlador decida automáticamente según las otras propiedades de conexión que haya establecido.
• OAuth: Configure esto para realizar la autenticación OAuth usando una cuenta de usuario estándar.
• OAuthJWT: Configure esto para realizar la autenticación OAuth usando una cuenta de servicio OAuth.
• GCPInstanceAccount: configure esto para obtener el token de acceso de la instancia de Google Cloud Platform.

ID de la Organización¶

El ID asociado con el recurso de la organización de Google Cloud Platform para conectarse.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Encuentra esto navegando a la consola en la nube. Haga clic en el menú desplegable de selección de proyectos y seleccione su organización de la lista. Luego, haga clic en More -> Settings. El ID de la organización se muestra en esta página.

Projecto ID¶

El ID asociado con el recurso del proyecto de Google Cloud Platform al que te gustaría conectarte.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Encuéntrelo navegando al panel de control de la consola en la nube y seleccionando su proyecto de Select from desplegable. El ID del proyecto estará presente en Project info tarjeta. Establézcalo en valores separados por comas para más de un Proyecto (Proyecto1, Proyecto2).

OAuth¶

Esta sección proporciona una lista completa de las propiedades de OAuth que puede configurar.

Iniciar OAuth¶

Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.

Valores Posibles¶

OFF, GETANDREFRESH, REFRESH

Tipo de Datos¶

string

Valor por Defecto¶

"OFF"

Observaciones¶

Las siguientes opciones están disponibles:

1. OFF: Indica que el flujo de OAuth será manejado en su totalidad por el usuario. Se requerirá un OAuthAccessToken para la autenticación.
2. GETANDREFRESH: indica que el conector manejará todo el flujo de OAuth. Si actualmente no existe ningún token, se obtendrá solicitándolo al usuario a través del navegador. Si existe un token, se actualizará cuando corresponda.
3. REFRESH: indica que el conector solo manejará la actualización de OAuthAccessToken. El conector nunca le pedirá al usuario que se autentique a través del navegador. El usuario debe manejar la obtención de OAuthAccessToken y OAuthRefreshToken inicialmente.

OAuthClientId¶

El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId valor, a veces también llamado clave de consumidor, y un secreto de cliente, el OAuthClientSecret.

OAuthClientSecretOAuthClientSecret¶

El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId, también denominada clave de consumidor. También recibirá un secreto de cliente, también llamado secreto de consumidor. Establezca el secreto del cliente en OAuthClientSecret propiedad.

Token de Acceso de OAuth¶

El token de acceso para conectarse mediante OAuth.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El OAuthAccessToken la propiedad se usa para conectarse usando OAuth. El OAuthAccessToken se recupera del servidor OAuth como parte del proceso de autenticación. Tiene un tiempo de espera dependiente del servidor y se puede reutilizar entre solicitudes.

El token de acceso se utiliza en lugar de su nombre de usuario y contraseña. El token de acceso protege sus credenciales manteniéndolas en el servidor.

URL de Devolución de Llamada¶

La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Durante el proceso de autenticación, el servidor de autorización de OAuth redirige al usuario a esta URL. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.

OAuthVerifier¶

El código verificador devuelto desde la URL de autorización de OAuth.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El código verificador devuelto desde la URL de autorización de OAuth. Esto se puede usar en sistemas en los que no se puede iniciar un navegador, como los sistemas sin cabeza.

Autenticación en Máquinas Sin Cabeza¶

Ver para obtener el OAuthVerifier valor.

Establezca OAuthSettingsLocation junto con OAuthVerifier. Cuando se conecta, el conector intercambia el OAuthVerifier para los tokens de autenticación de OAuth y los guarda, encriptados, en el archivo especificado. Establecer Iniciar OAuth para GETANDREFRESH automatizar el intercambio.

Una vez que se haya generado el archivo de configuración de OAuth, puede eliminar OAuthVerifier desde las propiedades de conexión y conéctese con OAuthSettingsLocation colocar.

Para actualizar automáticamente los valores del token de OAuth, establezca OAuthSettingsLocation y además configure InitiateOAuth refrescar.

OAuthRefreshToken¶

El token de actualización de OAuth para el token de acceso de OAuth correspondiente.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El OAuthRefreshToken la propiedad se usa para actualizar el OAuthAccessToken al usar la autenticación OAuth.

OAuthExpiresIn¶

La vida útil en segundos del AccessToken de OAuth.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Empareje con OAuthTokenTimestamp para determinar cuándo caducará el AccessToken.

OAuthTokenTimestamp¶

La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Emparéjese con OAuthExpiresIn para determinar cuándo expirará AccessToken.

JWT OAuth¶

Esta sección proporciona una lista completa de las propiedades de JWT OAuth que puede configurar.

OAuthJWTCert¶

El almacén de certificados JWT.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El nombre del almacén de certificados para el certificado de cliente.

El OAuthJWTCertType especifica el tipo de almacén de certificados especificado por OAuthJWTCert. Si la tienda está protegida con contraseña, especifique la contraseña en OAuthJWTCertPassword.

OAuthJWTCert se usa junto con OAuthJWTCertSubject para especificar certificados de cliente. Si OAuthJWTCert tiene un valor y OAuthJWTCertSubject, se inicia una búsqueda de un certificado. Consulte OAuthJWTCertSubject campo para más detalles.

Las designaciones de los almacenes de certificados dependen de la plataforma.

Las siguientes son designaciones de los almacenes de certificados de usuario y máquina más comunes en Windows:

En Java, el almacén de certificados normalmente es un archivo que contiene certificados y claves privadas opcionales.

Cuando el tipo de almacén de certificados es PFXFile, esta propiedad debe establecerse en el nombre del archivo. Cuando el tipo es PFXBlob, la propiedad debe establecerse en el contenido binario de un archivo PFX (es decir, almacén de certificados PKCS12).

OAuthJWTCertType¶

El tipo de almacén de claves que contiene el certificado JWT.

Valores Posibles¶

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB, GOOGLEJSON, GOOGLEJSONBLOB

Tipo de Datos¶

string

Valor por Defecto¶

"USER"

Observaciones¶

Esta propiedad puede tomar uno de los siguientes valores:

OAuthJWTCertPassword¶

La contraseña para el certificado OAuth JWT.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Si el almacén de certificados es de un tipo que requiere una contraseña, esta propiedad se usa para especificar esa contraseña para abrir el almacén de certificados.

Esto no es necesario cuando se usa GOOGLEJSON OAuthJWTCertType. Las claves JSON de Google no están cifradas.

OAuthJWTCertSubject¶

El asunto del certificado OAuth JWT.

Tipo de Datos¶

string

Valor por Defecto¶

"\*"

Observaciones¶

Al cargar un certificado, el asunto se utiliza para ubicar el certificado en el almacén.

Si no se encuentra una coincidencia exacta, se busca en la tienda temas que contengan el valor de la propiedad.

Si aún no se encuentra una coincidencia, la propiedad se establece en una cadena vacía y no se selecciona ningún certificado.

El valor especial "*" selecciona el primer certificado en el almacén de certificados.

El asunto del certificado es una lista separada por comas de valores y campos de nombre distinguido. Por ejemplo, "CN=www.server.com, OU=test, C=US, E=support@jitterbit.com". Los campos comunes y sus significados se muestran a continuación.

Si un valor de campo contiene una coma, debe estar entre comillas.

OAuthJWTIssuer¶

El emisor del token web de Java.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El emisor del token web de Java. Suele ser el ID del cliente o la dirección de Correo de la aplicación OAuth.

Esto no es necesario cuando se usa GOOGLEJSON OAuthJWTCertType. Las claves JSON de Google contienen una copia de la cuenta del emisor.

OAuthJWTAsunto¶

El sujeto de usuario para el que la aplicación solicita acceso delegado.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El sujeto de usuario para el que la aplicación solicita acceso delegado. Por lo general, el nombre de la cuenta de usuario o la dirección de correo.

SSL¶

Esta sección proporciona una lista completa de las propiedades SSL que puede configurar.

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:

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.

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%\\\GoogleDataCatalog 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%\\GoogleDataCatalog Data Provider\Schema" con %APPDATA% estando configurado en el directorio de configuración del usuario:

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.

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¶

Tamaño de Página¶

El número máximo de resultados que se devolverán por página del Google Data Catalog.

Tipo de Datos¶

int

Valor por Defecto¶

1000

Observaciones¶

El Pagesize la propiedad afecta la cantidad máxima de resultados que se devolverán por página del Google Data Catalog. 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, "*=*".

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.