Saltar al contenido

Detalles de Conexión de Adobe Analytics

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 Adobe Analytics

El conector aprovecha la API de AdobeAnalytics para habilitar el acceso a AdobeAnalytics.

Establecer una Conexión

Conexión a Adobe Analytics

ID de Empresa Global

GlobalCompanyId es una propiedad de conexión opcional. Si se deja vacío, el controlador intenta detectarlo automáticamente. Si desea especificar manualmente el Id. de empresa global, puede encontrarlo en la URL de solicitud para el extremo de usuarios/yo en la interfaz de usuario de Swagger. Después de iniciar sesión en la IU de Swagger, expanda el extremo de los usuarios y luego haga clic en el botón OBTENER usuarios/yo. Haga clic en los botones Pruébelo y Ejecutar. Tenga en cuenta su ID de empresa global que se muestra en la URL de solicitud que precede inmediatamente al extremo de usuarios/yo.

ID del Grupo de Informes

RSID es una propiedad de conexión opcional. Si no está configurado, el controlador intenta detectarlo automáticamente. Utilice esta propiedad si desea especificar manualmente el grupo de informes. Para obtener una lista completa de sus conjuntos de informes junto con sus identificadores junto al nombre, vaya a Admin -> Conjuntos de informes.

Después de configurar las propiedades de conexión de OAuth, está listo para conectarse a Adobe Analytics

Autenticación en Adobe Analytics

Adobe Analytics utiliza el estándar de autenticación OAuth. Puede autenticarse con la integración de OAuth o la integración de la cuenta de servicio.

Autenticar con la Integración de OAuth

Nota: Configure AuthScheme a OAuth para autenticar con este método.

Para autenticarse mediante OAuth, puede crear una aplicación para obtener el OAuthClientId, OAuthClientSecret, y CallbackURL propiedades de conexión o use las Credenciales integradas. Consulte Uso de la autenticación OAuth para obtener una guía de autenticación.

Autenticarse con la Integración de la Cuenta de Servicio

Nota: Configure AuthScheme a OAuthJWT para autenticar con este método.

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador.
Debe crear una aplicación en este flujo. Consulte Crear una aplicación OAuth personalizada para crear y autorizar una aplicación. A continuación, puede conectarse a los datos de Adobe Analytics a los que la cuenta de servicio tiene permiso para acceder.

Después de configurar las siguientes propiedades de conexión, está listo para conectarse:

  • InitiateOAuth: Establecer en GETANDREFRESH.
  • OAuthClientId: establezca la ID de cliente en la configuración de su aplicación.
  • OAuthClientSecret: establezca el secreto del cliente en la configuración de su aplicación.
  • OAuthJWTCertType: Establecido en "PUBLIC_KEY_FILE".
  • OAuthJWTCert: establezca la ruta al archivo .key que generó.
  • OAuthJWTCertPassword: Establezca la contraseña del archivo .key.
  • OAuthJWTSubject: El asunto, su ID de cuenta técnica de la integración de Adobe I/O Console, en el formato: id@techacct.adobe.com.
  • OAuthJWTIssuer: El emisor, su ID de organización de la integración de Adobe I/O Console, en el formato org_ident@AdobeOrg. Identifica su organización que se ha configurado para acceder a la API de Adobe I/O.

Cuando se conecta, el conector completa el flujo de OAuth para una cuenta de servicio.

  1. Crea y firma el JWT con el conjunto de notificaciones requerido por el conector.
  2. Intercambia el JWT por el token de acceso.
  3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.
  4. Envía el JWT para un nuevo token de acceso cuando el token caduca.

Uso de la Autenticación OAuth

OAuth requiere que el usuario que se autentica interactúe con Adobe Analytics mediante el navegador. El conector facilita esto de varias maneras, como se describe a continuación.

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

Deberá registrar una aplicación para obtener el OAuthClientId y OAuthClientSecret.

Cuándo Crear una Aplicación OAuth Personalizada
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 anterior.
  3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Credenciales Personalizadas

Cuándo Usar una Aplicación OAuth Personalizada

Debe crear una aplicación OAuth personalizada para conectarse a Adobe Analytics.

Autenticación de Escritorio con una Aplicación OAuth Personalizada

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 y Actualice el Token de Acceso de OAuth

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

  • OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
  • OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
  • CallbackURL: establezca esto en el URI de redirección definido cuando registró su aplicación. Por ejemplo: https://localhost:3333
  • 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. El proceso finaliza con el token de acceso devuelto por la API de Adobe Analytics.
  2. Actualiza el token de acceso cuando caduca.
  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 Adobe Analytics en servidores sin periféricos 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.

Puede seguir el flujo de autenticación de OAuth sin cabeza utilizando las credenciales de OAuth para su aplicación de OAuth personalizada.

Uso de las Credenciales para una Aplicación OAuth Personalizada

Cree una aplicación OAuth personalizada

Es posible que desee crear una aplicación OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en Adobe Analytics para otorgar permisos al conector.

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 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.

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.

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

  • 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.
  • 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: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
  • OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
  • CallbackURL: establezca esto en el URI de redirección que especificó 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.
  • 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.
  • 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

Debe crear una aplicación OAuth personalizada para conectarse a Adobe Analytics.

Crear una Aplicación para la Integración de OAuth

Siga los pasos a continuación para crear una aplicación personalizada y obtener las propiedades de conexión en un flujo de autenticación de OAuth específico.

  • Navegue a la siguiente URL: <https://console.adobe.io/home>.
  • Haga clic en el Create new project botón.
  • Selecciona el Add API opción.
  • Seleccionar Adobe Analytics, haga clic en Next, y luego seleccione OAuth y luego haga clic en Next de nuevo.
  • Selecciona el Web opción y complete los URI de redirección. Para una aplicación de escritorio, puede usar una URL localhost como https://localhost:33333. Para una aplicación web, proporcione la URL de la página a la que desea redirigir en su sitio web.
  • Haga clic en Save configured API.

Su cliente ya está creado. Observe que su cliente tiene una identificación de cliente (clave API) y un secreto de cliente. Estos serán necesarios para obtener su código de autenticación y generar tokens de acceso.

Crear una Aplicación para la Integración de Cuentas de Servicio

Siga los pasos a continuación para crear una aplicación personalizada y obtener las propiedades de conexión en un flujo de autenticación de cuenta de servicio específico.

  • Navegue a la siguiente URL: <https://console.adobe.io/home>.
  • Haga clic en el Create new project botón.
  • Selecciona el Add API opción.
  • Seleccionar Adobe Analytics, haga clic en Next, y luego seleccione Service Account (JWT) y luego haga clic en Next de nuevo.
  • Elija entre Generate a key pair o Upload your public key. Si elige Generate a key pair, guarde el archivo config.zip localmente ya que contiene el certificado que necesitará para completar la conexión. Haga clic en Next después de crear o cargar la clave.
  • Creating Your Own Public Key Certificate
    • MacOS and Linux
      Abra una terminal y ejecute el siguiente comando:
      req de openssl -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout private.key -out certificate_pub.crt
    • Windows
      Descargue un cliente OpenSSL como OpenSSL Light para generar certificados públicos. Los siguientes pasos serán para OpenSSL Light
      Abra una ventana de línea de comandos y ejecute los siguientes comandos:
      1) cd "C:\Archivos de programa\OpenSSL-Win64\bin"
      2) .\openssl.exe req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout private.key -out certificate_pub.crt
  • Seleccione uno o más perfiles de productos (en los perfiles de productos puede configurar los permisos de la aplicación) y luego haga clic en Save configured API.

Su cliente ya está creado. Observe que su cliente tiene ID de cliente (clave API ), secreto de cliente, ID de organización e ID de cuenta técnica. Estos serán necesarios para obtener el token JWT y generar tokens de acceso.

Características Avanzadas

Esta sección detalla una selección de funciones avanzadas del conector de Adobe Analytics.

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

Jitterbit Connector for Adobe Analytics 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

Jitterbit Connector para Adobe Analytics modela los objetos de Adobe Analytics como tablas y vistas relacionales. Las siguientes secciones muestran los objetos de la API disponibles y brindan más información sobre la ejecución de SQL en las APIs de Adobe Analytics.

Procedimientos almacenados

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

Procedimientos almacenados son interfaces similares a funciones para la fuente de datos. Se pueden utilizar para acceder a funciones adicionales de la API de Adobe Analytics.

Puntos de vista

Los informes se muestran como vistas, tablas que no se pueden modificar. Sin embargo, a diferencia de las vistas de base de datos tradicionales, no es muy útil seleccionar todas las métricas y dimensiones en una tabla determinada. La fecha es la dimensión predeterminada para cada informe, por lo que la consultar:

SELECT * FROM MyReport

se convertirá:

SELECT Date, {all the metrics here} FROM MyReport

Pero si la consultar tiene criterios, las dimensiones predeterminadas serán las dimensiones utilizadas en los criterios, como:

SELECT * FROM MyReport WHERE Country = 'England'

se convertirá:

SELECT Country, {all the metrics here} FROM MyReport WHERE Country = 'England'

Además, la API de Adobe Analytics limita a una la cantidad de dimensiones para las que puede solicitar datos por llamada a la API REST. Esto significa que la única forma en que el proveedor puede generar informes con múltiples dimensiones es desglosar las dimensiones.
Tomemos un ejemplo de consultar:

SELECT Country, City, Visits FROM MyReport
  • En primer lugar, el proveedor solicita todos los valores de la primera dimensión, País, supongamos que son: Inglaterra y Alemania.
  • En segundo lugar, el proveedor intenta desglosar Inglaterra con la dimensión City y obtiene, supongamos: Londres, Liverpool.
  • Finalmente, descompone Alemania con City y obtiene: Berlín, Frankfurt.

Si tuviéramos una tercera dimensión, el proveedor desglosaría cada ciudad con la tercera dimensión (lo que significa que haría una solicitud por ciudad).

Ahora, imagine un informe de cuatro dimensiones donde las dimensiones tienen muchos valores. La generación de ese informe requeriría muchas llamadas a la API.
Sin embargo, la API de Adobe Analytics nos permite proporcionar algunos filtros que pueden reducir enormemente el tiempo de ejecución de la consultar.

La API de Adobe Analytics utiliza los siguientes operadores lógicos: 'Y', 'O', 'NO'
y también utiliza los siguientes operadores: 'COINCIDIR', 'CONTIENE', 'COMIENZA CON' y 'FINALIZA CON', lo que significa que criterios como los siguientes se manejarán en el lado del servidor:

... WHERE Dimension = 'Value'
... WHERE Dimension LIKE '%value%'
... WHERE Dimension1 LIKE '%value' AND Dimension2 = 'Value2'
... WHERE Dimension LIKE 'value%'
... WHERE Dimension1 = 'Value1' AND Dimension2 = 'Value2'
... WHERE Dimension = 'Value1' OR Dimension = 'Value2' OR Dimension = 'Value3'
... WHERE Dimension IN ('Value1', 'Value2', 'Value3', 'Value4')
... WHERE (Dimension1 = 'value1' OR Dimension1 = 'Value2') AND (Dimension2 = 'value3' OR Dimension2 = 'value4')

Se recomienda encarecidamente utilizar tantos filtros como sea posible, de lo contrario, las consultas con muchas dimensiones pueden llevar mucho tiempo.

Definición de Informes Personalizados

Para crear una vista de informe sobre una consultar, puede utilizar Crear informe procedimiento almacenado. Crear informe procedimiento almacenado* proporciona una manera fácil de generar nuevas definiciones de vista con una combinación personalizada de dimensiones y métricas. Llamarlo creará un nuevo archivo de esquema que puede consultar como cualquier otra vista.

El procedimiento almacenado* toma un nombre de vista, una lista separada por comas de nombres de métricas, una lista separada por comas de ID de métricas, una lista separada por comas de nombres de dimensiones, una lista separada por comas de ID de dimensiones y una carpeta de salida como entradas. Deberá configurar Location propiedad de conexión a la carpeta que contiene los nuevos archivos de secuencia de comandos para poder acceder a ellos; el Location se puede establecer en lugar de la carpeta de salida.
Puede obtener los ID de métricas/dimensiones consultando las vistas de métricas/dimensiones.

SELECT Id, Name FROM Dimensions
SELECT Id, Name FROM Metrics

Por ejemplo, para usar un nuevo esquema junto con los esquemas predeterminados, configure Location propiedad a la subcarpeta db en la carpeta de instalación y realice la siguiente llamada:

EXEC CreateReport Dimensions = 'Country, City', Metrics = 'PageViews, Visits', TableName = 'MyCustomReport'

El conector descarga la mayor parte posible del procesamiento de la declaración SELECT a las APIs de Adobe Analytics 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 Adobe Analytics

Nombre Descripción
AdsReport Genera reportes de datos respecto a los anuncios de tu sitio web.
CalculatedMetrics Consulta las métricas calculadas disponibles en AdobeAnalytics.
CollectionSuites Consulte los conjuntos de colecciones disponibles en AdobeAnalytics.
Dimensions Consulta las dimensiones disponibles en AdobeAnalytics.
Metrics Consulta las métricas disponibles en AdobeAnalytics.
OrdersReport Genere informes de datos de los pedidos realizados en su sitio web.
ProductsReport Genere informes de datos sobre sus productos.
Segments Consulta los segmentos disponibles en AdobeAnalytics.
SiteReport Genere informes de datos sobre el tráfico de su sitio web.
Users Consulta los usuarios disponibles en AdobeAnalytics.

Informe de Anuncios

Genera reportes de datos respecto a los anuncios de tu sitio web.

Ver Información Específica

Consulte la explicación en la sección "Modelo de datos" para aprender a crear consultas óptimas. Los siguientes son algunos casos de uso para este informe:

SELECT Country, City, AdClicks, AdImpressions, ClickThroughs FROM AdsReport
SELECT Page, AdClicks, AdImpressions, ClickThroughs FROM AdsReport
SELECT Date, Revenue FROM AdsReport

Puede activar la ejecución del lado del cliente configurando SupportEnhancedSQL a verdadero, en cuyo caso cualquier filtro que Adobe Analytics no maneje, será manejado por el lado del cliente.

Columnas
Nombre Tipo EsDimensión EsMetrico Dimensión por defecto Descripción
Country String Verdadero Nombre del país.
City String Verdadero Nombre de la ciudad.
Page String Verdadero Nombre de la página en la que estaba el anuncio.
Date Date Verdadero Verdadero La fecha y hora de los datos proporcionados.
PageViews Int Verdadero Número de páginas vistas.
AdClicks Int Verdadero Número de clics en anuncios.
AdImpressions Int Verdadero Número de aimpresiones.
ClickThroughs Int Verdadero Número de clics.
Revenue Decimal Verdadero Los ingresos obtenidos de los anuncios.
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.

Nombre Tipo Descripción
StartDate Datetime Use esto para filtrar informes por la fecha de inicio del informe.
EndDate Datetime Use esto para filtrar informes por la fecha de finalización del informe.
SegmentId String Use esto para filtrar informes por un segmento en particular.

Métricas Calculadas

Consulta las métricas calculadas disponibles en AdobeAnalytics.

Columnas
Nombre Tipo EsDimensión EsMetrico Dimensión por defecto Descripción
Id [KEY] String Identificador único de la métrica calculada.
Name String El nombre de la métrica calculada.
ReportSuiteName String El nombre del conjunto de informes en el que se encuentra la métrica calculada.
Description String Una descripción de la métrica calculada.
Created Datetime La fecha y hora en que se creó la métrica calculada.
Modified Datetime La fecha y hora en que se modificó la métrica calculada.
Type String El tipo de la métrica calculada. Por ejemplo int, decimal, porcentaje, etc.
OwnerId String Identificador único del usuario que creó la métrica calculada.
OwnerName String Nombre del usuario que creó la métrica calculada.
Category String La categoría de la métrica calculada.
SiteTitle String El título del sitio.
Polarity String Toma dos valores: positivo y negativo. Determina si es positivo o no si la métrica aumenta.
Precision Integer La precisión de la métrica calculada.
Template String Atributo adicional que se usa para identificar plantillas cuando includeType=templates.
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.

Nombre Tipo Descripción
IncludeType String De forma predeterminada, las respuestas sin este parámetro incluyen solo métricas calculadas que pertenecen al usuario. Son posibles los siguientes valores: 1) todo: devuelve todas las métricas calculadas vinculadas a esta empresa. 2) shared: devuelve métricas calculadas compartidas con el usuario. 3) plantillas: devuelve todas las plantillas de métricas calculadas.

ColecciónSuites

Consulte los conjuntos de colecciones disponibles en AdobeAnalytics.

Columnas
Nombre Tipo EsDimensión EsMetrico Dimensión por defecto Descripción
Rsid [KEY] String Identificador único del conjunto de recopilación.
Name String El nombre de la suite de recopilación.
ParentRsid String Identificador único del padre de este conjunto de recopilación.
Currency String Moneda predeterminada utilizada en este conjunto de colecciones.
Type String El tipo de suite de recopilación. Por ejemplo, conjunto de informes.
Timezone String La zona horaria del conjunto de recopilación.

Dimensiones

Consulta las dimensiones disponibles en AdobeAnalytics.

Columnas
Nombre Tipo EsDimensión EsMetrico Dimensión por defecto Descripción
Id [KEY] String Identificador único de la dimensión.
RSID String Identificador único del conjunto de informes en el que se encuentra la dimensión.
Title String El título de la dimensión.
Name String El nombre de la dimensión.
Type String El tipo de la dimensión. Por ejemplo, cadena, int, enumeración, etc.
Description String Una descripción de la dimensión.
Category String La categoría de la dimensión.
Pathable Boolean Si la dimensión es transitable o no.
Segmentable Boolean Si la dimensión es segmentable o no.
ReportType String El tipo de los informes en los que esta dimensión es válida.
Support String El tipo de los informes en los que se admite esta dimensión.

Métrica

Consulta las métricas disponibles en AdobeAnalytics.

Columnas
Nombre Tipo EsDimensión EsMetrico Dimensión por defecto Descripción
Id [KEY] String Identificador único de la métrica.
RSID String Identificador único del conjunto de informes en el que se encuentra la métrica.
Title String El título de la métrica.
Name String El nombre de la métrica.
Type String El tipo de la métrica, por ejemplo, int, porcentaje, moneda, etc.
Description String Una descripción para la métrica.
Category String La categoría de la métrica.
Calculated Boolean Si esta métrica es o no una métrica calculada.
Segmentable Boolean Si esta métrica es segmentable o no.
Polarity String Toma dos valores: positivo y negativo. Determina si es positivo o no si la métrica aumenta.
Precision Integer La precisión de la métrica.

Informe de Pedidos

Genere informes de datos de los pedidos realizados en su sitio web.

Ver Información Específica

Consulte la explicación en la sección "Modelo de datos" para aprender a crear consultas óptimas. Los siguientes son algunos casos de uso para este informe:

SELECT Date, CartViews, CartAdditions, CartRemovals FROM OrdersReport
SELECT Date, Orders, OrdersPerVisitor FROM OrdersReport
SELECT Date, Revenue FROM OrdersReport

Puede activar la ejecución del lado del cliente configurando SupportEnhancedSQL a verdadero, en cuyo caso cualquier filtro que Adobe Analytics no maneje, será manejado por el lado del cliente.

Columnas
Nombre Tipo EsDimensión EsMetrico Dimensión por defecto Descripción
Date Date Verdadero Verdadero La fecha y hora de los datos proporcionados.
Carts Int Verdadero Número de carros.
CartAdditions Int Verdadero Número de adiciones al carrito.
CartRemovals Int Verdadero Número de carros retirados.
CartViews Int Verdadero Número de vistas del carrito.
Orders Int Verdadero Número de pedidos realizados.
ConversionRate Int Verdadero Porcentaje de pedidos convertidos en compra.
OrdersPerVisitor Int Verdadero Número de pedidos por visitante.
Revenue Decimal Verdadero Los ingresos obtenidos de las ventas.
RevenuePerOrder Decimal Verdadero Ingreso medio por cada pedido.
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.

Nombre Tipo Descripción
StartDate Datetime Use esto para filtrar informes por la fecha de inicio del informe.
EndDate Datetime Use esto para filtrar informes por la fecha de finalización del informe.
SegmentId String Use esto para filtrar informes por un segmento en particular.

ProductosInforme

Genere informes de datos sobre sus productos.

Ver Información Específica

Consulte la explicación en la sección "Modelo de datos" para aprender a crear consultas óptimas. Los siguientes son algunos casos de uso para este informe:

SELECT Product, Date, ProductViews, Units FROM ProductsReport
SELECT Product, Orders, Checkouts FROM ProductsReport
SELECT Product, Date, Revenue FROM ProductsReport

Puede activar la ejecución del lado del cliente configurando SupportEnhancedSQL a verdadero, en cuyo caso cualquier filtro que Adobe Analytics no maneje, se maneja del lado del cliente.

Columnas
Nombre Tipo EsDimensión EsMetrico Dimensión por defecto Descripción
Product String Verdadero Nombre del producto.
Date Date Verdadero Verdadero La fecha y hora de los datos proporcionados.
ProductViews Int Verdadero Número de vistas que ha recibido un producto.
CartAdditions Int Verdadero Número de veces que se agregó el producto en un carrito.
Checkouts Int Verdadero Número de cajas.
Orders Int Verdadero Numero de ordenes.
Units Int Verdadero Número de unidades.
Revenue Decimal Verdadero Ingresos obtenidos por la venta de productos.
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.

Nombre Tipo Descripción
StartDate Datetime Use esto para filtrar informes por la fecha de inicio del informe.
EndDate Datetime Use esto para filtrar informes por la fecha de finalización del informe.
SegmentId String Use esto para filtrar informes por un segmento en particular.

Segmentos

Consulta los segmentos disponibles en AdobeAnalytics.

Columnas
Nombre Tipo EsDimensión EsMetrico Dimensión por defecto Descripción
Id [KEY] String Identificador único del segmento.
Name String El nombre del segmento.
ReportSuiteName String El nombre del conjunto de informes en el que se creó el segmento.
Description String Una descripción para el segmento.
Created Datetime La fecha y hora en que se creó el segmento.
Modified Datetime La fecha y hora en que se modificó por última vez el segmento.
OwnerId String El identificador único del usuario que creó el segmento.
OwnerName String El nombre del usuario que creó el segmento.
Version String La versión del segmento.
Type String Una lista separada por comas de tipos de segmentos. Los valores permitidos son: shared, templates, curatedItem.
SiteTitle String El título del sitio.

Informe del Sitio

Genere informes de datos sobre el tráfico de su sitio web.

Ver Información Específica

Consulte la explicación en la sección "Modelo de datos" para aprender a crear consultas óptimas. Los siguientes son algunos casos de uso para este informe:
¿De dónde viene la mayor parte del tráfico? (país Ciudad)

SELECT Country, City, PageViews, Visits FROM SiteReport

¿A qué hora del día el sitio web está más ocupado?

SELECT HourOfDay, PageViews, Visits FROM SiteReport

¿Qué motores de búsqueda utilizan más nuestros usuarios para encontrarnos?

SELECT SearchEngine, Visits, UniqueVisitors FROM SiteReport

¿Quién recomienda a los usuarios que nos visiten?

SELECT Referrer, Visits, UniqueVisitors FROM SiteReport

¿La gente viene para quedarse o suele rebotar?

SELECT Date, Bounces, BounceRate FROM SiteReport

¿Cuál es la página más vista?

SELECT Page, PageViews, Visits, UniqueVisitors FROM SiteReport

Puede activar la ejecución del lado del cliente configurando SupportEnhancedSQL a verdadero, en cuyo caso cualquier filtro que Adobe Analytics no maneje, será manejado por el lado del cliente.

Columnas
Nombre Tipo EsDimensión EsMetrico Dimensión por defecto Descripción
Date Date Verdadero Verdadero La fecha y hora de la primera entrada de registro de una sesión.
HourOfDay String Verdadero La hora del día de la primera entrada de registro de una sesión.
Country String Verdadero Agrupa el tráfico web por el país en el que se encontraba el cliente.
City String Verdadero Agrupa el tráfico web por la ciudad donde se encontraba el cliente.
SearchEngine String Verdadero El nombre de dominio de segundo nivel del primer sitio web (que es un motor de búsqueda) que refirió a un visitante al sitio durante una sesión (tal como lo proporciona el navegador del visitante).
Browser String Verdadero El tipo de agente de usuario utilizado por el visitante, incluido el número de versión (por ejemplo, MSIE 6.0).
OperatingSystems String Verdadero Agrupa el tráfico web por el sistema operativo utilizado por el cliente. Los sistemas operativos móviles y de escritorio aparecen en este informe.
Page String Verdadero El nombre de cada página visitada durante una sesión. Inicialmente, el nombre de cada página es el mismo que el URI, pero se puede cambiar para facilitar la interpretación.
Referrer String Verdadero El nombre de dominio de segundo nivel del sitio web que primero refirió una sesión al sitio (tal como lo proporciona el navegador del visitante).
PageViews Integer Verdadero El número de páginas vistas. Una vista de página es una solicitud de una página definida (no se cuenta el acceso a imágenes y otros tipos de contenido filtrado).
Visits Integer Verdadero El número de visitas.
UniqueVisitors Integer Verdadero El número de visitantes únicos.
Bounces Integer Verdadero El número de rebotes. Un rebote es una visita que consiste en una única llamada al servidor.
BounceRate Integer Verdadero El porcentaje de visitas que contienen un único hit.
SinglePageVisits Integer Verdadero El número de visitas a una sola página.
TimeSpentPerVisit Integer Verdadero La cantidad promedio de tiempo que los visitantes interactúan con un elemento de dimensión específico durante cada visita.
TimeSpentPerVisitor Integer Verdadero La cantidad promedio de tiempo que los visitantes interactúan con un elemento de dimensión específico a lo largo de la vida del visitante (duración de su cookie).
TotalSecondsSpent Integer Verdadero Representa la cantidad total de tiempo que los visitantes interactúan con un elemento de dimensión específico.
Revenue Decimal Verdadero El monto total en dólares por la suma del pedido de cada producto.
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.

Nombre Tipo Descripción
StartDate Datetime Use esto para filtrar informes por la fecha de inicio del informe.
EndDate Datetime Use esto para filtrar informes por la fecha de finalización del informe.
SegmentId String Use esto para filtrar informes por un segmento en particular.

Usuarios

Consulta los usuarios disponibles en AdobeAnalytics.

Columnas
Nombre Tipo EsDimensión EsMetrico Dimensión por defecto Descripción
LoginId [KEY] String Identificador único del usuario.
ImsUserId String El ID de usuario de IMS. Esto se usa solo para usuarios internos como autores, revisores, administradores, desarrolladores, etc.
CompanyId String Identificador único de la empresa.
CreateDate Timestamp La fecha en que se creó el usuario.
Disabled Boolean Si la cuenta de este usuario está deshabilitada o no.
Email String El correo del usuario.
FirstName String El primer nombre del usuario.
LastName String El apellido del usuario.
FullName String El nombre completo del usuario.
LastAccess Timestamp Cuando el usuario accedió a su cuenta por última vez.
LastLogin Timestamp Cuando el usuario inició sesión por última vez.
Login String Nombre de inicio de sesión.
PhoneNumber String El número de teléfono del usuario.
Title String El título del usuario.

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.

Conector Jitterbit para Procedimientos Almacenados de Adobe Analytics

Nombre Descripción
CreateReport Crea un informe personalizado proporcionando dimensiones y métricas.
GetOAuthAccessToken Obtiene un token de autenticación de AdobeAnalytics.
GetOAuthAuthorizationURL Obtiene la URL de autorización que el usuario debe abrir por separado para otorgar acceso a su aplicación. Solo se necesita al desarrollar aplicaciones web. Solicitará el OAuthAccessToken desde esta URL.
RefreshOAuthAccessToken Adobe Analytics no admite token de actualización. Entonces, este procedimiento almacenado* llamará al procedimiento GetOAuthAccessToken internamente para iniciar el flujo de OAuth desde el principio.

Crear Reporte

Crea un informe personalizado proporcionando dimensiones y métricas.

Procedimiento Almacenado* Información Específica

Para crear una vista de informe sobre una consultar, puede utilizar Crear informe procedimiento almacenado. Crear informe procedimiento almacenado* proporciona una manera fácil de generar nuevas definiciones de vista con una combinación personalizada de dimensiones y métricas. Llamarlo creará un nuevo archivo de esquema que puede consultar como cualquier otra vista.

El procedimiento almacenado* toma un nombre de vista, una lista separada por comas de nombres de métricas, una lista separada por comas de ID de métricas, una lista separada por comas de nombres de dimensiones, una lista separada por comas de ID de dimensiones y una carpeta de salida como entradas. Deberá configurar Location propiedad de conexión a la carpeta que contiene los nuevos archivos de secuencia de comandos para poder acceder a ellos; el Location se puede establecer en lugar de la carpeta de salida.
Puede obtener los ID de métricas/dimensiones consultando las vistas de métricas/dimensiones.

SELECT Id, Name FROM Dimensions
SELECT Id, Name FROM Metrics

Por ejemplo, para usar un nuevo esquema junto con los esquemas predeterminados, configure Location propiedad a la subcarpeta db en la carpeta de instalación y realice la siguiente llamada:

EXEC CreateReport Dimensions = 'Country, City', DimensionIds = 'variables/geocountry, variables/geocity', Metrics = 'PageViews, Visits', MetricIds = 'metrics/pageviews, metrics/visits', TableName = 'MyCustomReport'

Las dimensiones y las métricas deben tener sus respectivos Id especificados en las entradas de DimensionIds y MetricIds.

Entrada
Nombre Tipo Obligatorio Descripción
TableName String Cierto El nombre de la nueva tabla.
Description String Falso Una descripción opcional para la tabla.
OutputFolder String Falso La ruta de salida del nuevo archivo de esquema. El valor de la propiedad Cadena de conexión de ubicación se utilizará de forma predeterminada. Deberá establecer la propiedad de conexión Ubicación en la ubicación de sus archivos de esquema.
DimensionIds String Cierto Una lista separada por comas de los ID de las dimensiones.
MetricIds String Cierto Una lista separada por comas de los ID de las métricas.
Columnas del conjunto de resultados
Nombre Tipo Descripción
Success String Si el esquema se creó correctamente o no.
SchemaFile String El archivo de esquema generado.

GetOAuthAccessToken

Obtiene un token de autenticación de AdobeAnalytics.

Entrada
Nombre Tipo Obligatorio Descripción
AuthMode String Falso El tipo de modo de autenticación a utilizar. Seleccione Aplicación para obtener tokens de autenticación a través de una aplicación de escritorio. Seleccione Web para obtener tokens de autenticación a través de una aplicación web. Los valores permitidos son APP, WEB. El valor predeterminado es APLICACIÓN.
Scopes String Falso Una lista separada por comas de permisos para solicitar al usuario. Consulte la API de AdobeAnalytics para obtener una lista de los permisos disponibles. El valor predeterminado es openid, AdobeID, read_organizations, adicional_info.job_function, adicional_info.projectedProductContext.
CallbackUrl String Falso La URL a la que se redirigirá al usuario después de autorizar su aplicación. Este valor debe coincidir con la URL de redireccionamiento que especificó en la configuración de la aplicación AdobeAnalytics. Solo es necesario cuando el parámetro Authmode es Web.
Verifier String Falso El verificador devuelto por AdobeAnalytics después de que el usuario haya autorizado su aplicación para tener acceso a sus datos. Este valor se devolverá como un parámetro para la URL de devolución de llamada.
State String Falso Indica cualquier estado que pueda ser de utilidad para su solicitud al recibir la respuesta. Su aplicación recibe el mismo valor que envió, ya que este parámetro realiza un viaje de ida y vuelta al servidor de autorización de AdobeAnalytics y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, nonces y mitigaciones de falsificación de solicitudes entre sitios.
Columnas del conjunto de resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de acceso utilizado para la comunicación con AdobeAnalytics.
OAuthRefreshToken String El token de actualización de OAuth. Es lo mismo que el token de acceso en el caso de AdobeAnalytics.
ExpiresIn String El tiempo de vida restante en el token de acceso. Un -1 indica que no caducará.

GetOAuthAuthorizationURL

Obtiene la URL de autorización que el usuario debe abrir por separado para otorgar acceso a su aplicación. Solo se necesita al desarrollar aplicaciones web. Solicitará el OAuthAccessToken desde esta URL.

Entrada
Nombre Tipo Obligatorio Descripción
CallbackUrl String Falso La URL a la que se redirigirá al usuario después de autorizar su aplicación. Este valor debe coincidir con la URL de redirección en la configuración de la aplicación AdobeAnalytics.
Scopes String Falso Una lista separada por comas de ámbitos para solicitar al usuario. Consulte la documentación de la API de AdobeAnalytics para obtener una lista de los permisos disponibles. El valor predeterminado es openid, AdobeID, read_organizations, adicional_info.job_function, adicional_info.projectedProductContext.
State String Falso Indica cualquier estado que pueda ser de utilidad para su solicitud al recibir la respuesta. Su aplicación recibe el mismo valor que envió, ya que este parámetro realiza un viaje de ida y vuelta al servidor de autorización de AdobeAnalytics y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, nonces y mitigaciones de falsificación de solicitudes entre sitios.
Columnas del conjunto de resultados
Nombre Tipo Descripción
URL String La URL de autorización, ingresada en un navegador web para obtener el token de verificación y autorizar su aplicación.

RefreshOAuthAccessToken

Adobe Analytics no admite token de actualización. Entonces, este procedimiento almacenado* llamará al procedimiento GetOAuthAccessToken internamente para iniciar el flujo de OAuth desde el principio.

Entrada
Nombre Tipo Obligatorio Descripción
OAuthRefreshToken String Falso Establezca esto en algún valor de prueba. No hará ninguna diferencia ya que este procedimiento iniciará el flujo de OAuth desde el principio. El valor predeterminado es prueba.
Columnas del conjunto de resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de autenticación devuelto por AdobeAnalytics. Esto se puede usar en llamadas posteriores a otras operaciones para este servicio en particular.
ExpiresIn String El tiempo de vida restante en el token de acceso.

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 esquemas

Las siguientes tablas devuelven metadatos de la base de datos para Adobe Analytics:

Tablas de origen 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.

Consultar tablas de información

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_procedures

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:adobeanalytics: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 de consultas en colaboración

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.

Autenticación

Propiedad Descripción
AuthScheme El tipo de autenticación que se utilizará al conectarse a Adobe Analytics.
GlobalCompanyId El identificador de su empresa. Si no está configurado, el controlador intenta detectarlo automáticamente.
RSID Su identificador de grupo de informes. Si no está configurado, el controlador intenta detectarlo automáticamente.

OAuth

Propiedad Descripción
InitiateOAuth Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
OAuthClientId El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthClientSecret El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthAccessToken El token de acceso para conectarse mediante OAuth.
CallbackURL 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.
OAuthVerifier El código verificador devuelto desde la URL de autorización de OAuth.
OAuthRefreshToken El token de actualización de OAuth para el token de acceso de OAuth correspondiente.
OAuthExpiresIn La vida útil en segundos del AccessToken de OAuth.
OAuthTokenTimestamp La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

JWT OAuth

Propiedad Descripción
OAuthJWTCert El almacén de certificados JWT.
OAuthJWTCertType El tipo de almacén de claves que contiene el certificado JWT.
OAuthJWTCertPassword La contraseña para el certificado OAuth JWT.
OAuthJWTCertSubject El asunto del certificado OAuth JWT.
OAuthJWTIssuer El emisor del token web de Java.
OAuthJWTSubject El sujeto de usuario para el que la aplicación solicita acceso delegado.

SSL

Propiedad Descripción
SSLServerCert El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Esquema

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.

Misceláneas

Propiedad Descripción
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 Adobe Analytics.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la 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
AuthScheme El tipo de autenticación que se utilizará al conectarse a Adobe Analytics.
GlobalCompanyId El identificador de su empresa. Si no está configurado, el controlador intenta detectarlo automáticamente.
RSID Su identificador de grupo de informes. Si no está configurado, el controlador intenta detectarlo automáticamente.

Esquema de autenticación

El tipo de autenticación que se utilizará al conectarse a Adobe Analytics.

Valores posibles

Auto, OAuth, OAuthJWT

Tipo de datos

string

Valor predeterminado

"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.

GlobalCompanyId

El identificador de su empresa. Si no está configurado, el controlador intenta detectarlo automáticamente.

Tipo de datos

string

Valor predeterminado

""

Observaciones

El identificador de su empresa. Si no está configurado, el controlador intenta detectarlo automáticamente.

RSID

Su identificador de conjunto de informes. Si no está configurado, el controlador intenta detectarlo automáticamente.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Su identificador de conjunto de informes. Si no está configurado, el controlador intenta detectarlo automáticamente.

OAuth

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

Propiedad Descripción
InitiateOAuth Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
OAuthClientId El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthClientSecret El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthAccessToken El token de acceso para conectarse mediante OAuth.
CallbackURL 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.
OAuthVerifier El código verificador devuelto desde la URL de autorización de OAuth.
OAuthRefreshToken El token de actualización de OAuth para el token de acceso de OAuth correspondiente.
OAuthExpiresIn La vida útil en segundos del AccessToken de OAuth.
OAuthTokenTimestamp La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

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 predeterminado

"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 predeterminado

""

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.

OAuthClientSecret

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

Tipo de datos

string

Valor predeterminado

""

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 predeterminado

""

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 predeterminado

"http://localhost:33333"

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 predeterminado

""

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 predeterminado

""

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 predeterminado

""

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 predeterminado

""

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.

Propiedad Descripción
OAuthJWTCert El almacén de certificados JWT.
OAuthJWTCertType El tipo de almacén de claves que contiene el certificado JWT.
OAuthJWTCertPassword La contraseña para el certificado OAuth JWT.
OAuthJWTCertSubject El asunto del certificado OAuth JWT.
OAuthJWTIssuer El emisor del token web de Java.
OAuthJWTSubject El sujeto de usuario para el que la aplicación solicita acceso delegado.

OAuthJWTCert

El almacén de certificados JWT.

Tipo de datos

string

Valor predeterminado

""

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:

Propiedad Descripción
MY Un almacén de certificados que contiene certificados personales con sus claves privadas asociadas.
CA Certificados de la autoridad certificadora.
ROOT Certificados raíz.
SPC Certificados de editor de software.

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

Tipo de datos

string

Valor predeterminado

"PEMKEY_FILE"

Observaciones

Esta propiedad puede tomar uno de los siguientes valores:

Propiedad Descripción
USER Para Windows, esto especifica que el almacén de certificados es un almacén de certificados propiedad del usuario actual. Nota: Este tipo de tienda no está disponible en Java.
MACHINE Para Windows, esto especifica que el almacén de certificados es un almacén de máquinas. Nota: este tipo de tienda no está disponible en Java.
PFXFILE El almacén de certificados es el nombre de un archivo PFX (PKCS12) que contiene certificados.
PFXBLOB El almacén de certificados es una cadena (codificada en base 64) que representa un almacén de certificados en formato PFX (PKCS12).
JKSFILE El almacén de certificados es el nombre de un archivo de almacén de claves Java (JKS) que contiene certificados. Nota: este tipo de tienda solo está disponible en Java.
JKSBLOB El almacén de certificados es una cadena (codificada en base 64) que representa un almacén de certificados en formato de almacén de claves Java (JKS). Nota: este tipo de tienda solo está disponible en Java.
PEMKEY_FILE El almacén de certificados es el nombre de un archivo con codificación PEM que contiene una clave privada y un certificado opcional.
PEMKEY_BLOB El almacén de certificados es una cadena (codificada en base64) que contiene una clave privada y un certificado opcional.
PUBLIC_KEY_FILE El almacén de certificados es el nombre de un archivo que contiene un certificado de clave pública con codificación PEM o DER.
PUBLIC_KEY_BLOB El almacén de certificados es una cadena (codificada en base 64) que contiene un certificado de clave pública con codificación PEM o DER.
SSHPUBLIC_KEY_FILE El almacén de certificados es el nombre de un archivo que contiene una clave pública de estilo SSH.
SSHPUBLIC_KEY_BLOB El almacén de certificados es una cadena (codificada en base 64) que contiene una clave pública de estilo SSH.
P7BFILE El almacén de certificados es el nombre de un archivo PKCS7 que contiene certificados.
PPKFILE El almacén de certificados es el nombre de un archivo que contiene una PPK (clave privada PuTTY).
XMLFILE El almacén de certificados es el nombre de un archivo que contiene un certificado en formato XML.
XMLBLOB El almacén de certificados es una cadena que contiene un certificado en formato XML.

OAuthJWTCertPassword

La contraseña para el certificado OAuth JWT.

Tipo de datos

string

Valor predeterminado

""

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.

OAuthJWTCertSubject

El asunto del certificado OAuth JWT.

Tipo de datos

string

Valor predeterminado

"\*"

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.

Campo Significado
CN Nombre común. Este es comúnmente un nombre de alojar como www.server.com.
O Organización
OU Unidad organizativa
L localidad
S Estado
C País
E Dirección de Correo

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 predeterminado

""

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.

OAuthJWTSubject

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

Tipo de datos

string

Valor predeterminado

""

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.

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 predeterminado

""

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 predeterminado

"%APPDATA%\\\AdobeAnalytics Data Provider\\Schema"

Comentarios

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%\\AdobeAnalytics 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 predeterminado

""

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.

Tablas

Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.

Tipo de datos

string

Valor predeterminado

""

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.

Vistas

Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.

Tipo de datos

string

Valor predeterminado

""

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.

Varios

Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.

Propiedad Descripción
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 Adobe Analytics.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

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.

Tipo de datos

int

Valor predeterminado

-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 predeterminado

""

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 formato
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 Adobe Analytics.

Tipo de datos

int

Valor predeterminado

50

Observaciones

El Pagesize la propiedad afecta al número máximo de resultados que se devolverán por página desde Adobe Analytics. 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 predeterminado

""

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, "*=*".

Tiempo de espera

El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Tipo de datos

int

Valor predeterminado

60

Comentarios

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.