Detalles de Conexión de Microsoft Azure Table Storage¶

Introducción¶

Versión del conector

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

Empezando¶

Compatibilidad con la versión de Azure Table Storage

Establecer una Conexión¶

Conexión a las APIs de Azure Table Storage¶

El controlador se conectará a la cuenta de Azure Table Storage especificada por Account. De forma predeterminada, las conexiones a Azure Table Storage están protegidas a través de SSL, aunque esto se puede controlar a través de UseSSL. El método de autenticación para Azure Table Storage está determinado por AuthScheme propiedad.

Autenticación en Azure Table Storage¶

Los siguientes mecanismos se pueden utilizar para la autenticación.

Autenticación con Clave de Acceso¶

Colocar Account al nombre de la cuenta de almacenamiento y configure AccessKey de la cuenta de almacenamiento para conectarse. Siga los pasos a continuación para obtener estos valores:

Si usa Almacenamiento como Backend (por defecto):

1. Inicie sesión en Azure Portal y seleccione Cuentas de almacenamiento en el menú de servicios de la izquierda.
2. Si actualmente no tiene ninguna cuenta de almacenamiento, cree una haciendo clic en el botón Agregar.
3. Haga clic en el enlace de la cuenta de almacenamiento que desea usar y seleccione Claves de acceso en Configuración. La ventana Claves de acceso contiene el nombre y la clave de la cuenta de almacenamiento (puede usar la clave 1 o la clave 2 para conectarse) que necesitará usar en el conector. Estas propiedades se asignan al Account y AccessKey propiedades de conexión del conector respectivamente.

Si usa CosmosDB como Backend:

1. Inicie sesión en Azure Portal y seleccione Cosmos DB en el menú de servicios de la izquierda.
2. Haga clic en el enlace de la cuenta de Cosmos DB que desea usar y seleccione Cadena de conexión en Configuración. La ventana Cadena de conexión contiene el nombre de la cuenta de Cosmos DB y la clave principal que deberá usar en el conector. Estas propiedades se asignan al Account y AccessKey propiedades de conexión del conector respectivamente.

Autenticación con Firma de Acceso Compartido¶

Colocar Account al nombre de la cuenta de almacenamiento y configure SharedAccessSignature a una firma válida de un recurso al que conectarse. El SharedAccessSignature puede generarse con una herramienta como Azure Storage Explorer.

Normalmente cuando SharedAccessSignature se utiliza, la tabla específica con la que trabajar también debe especificarse a través de Tables propiedad de conexión. Si no se especifica ninguna tabla, se intentará una lista de tabla, pero puede fallar debido a la falta de permisos.

Notas Importantes¶

Procedimientos Almacenados¶

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

Archivos de Configuración y Sus Rutas¶

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

Características Avanzadas¶

Esta sección detalla una selección de características avanzadas del conector Azure Table Storage.

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 Azure Table Storage le permite definir una tabla virtual cuyo contenido se decide mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Usando un Archivo de Configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

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

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

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

Esquema para Vistas Definidas por el Usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

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

Dando como resultado la consultar efectiva a la fuente:

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

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL¶

Personalización de la Configuración SSL¶

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos¶

El conector le permite acceder a los datos en Azure Table Storage a través de una interfaz estándar similar a una base de datos. Las tablas de Azure son bases de datos en la nube NoSQL altamente escalables que son muy diferentes de una base de datos normal. En esta sección, describimos cómo modelamos las tablas de Azure sin esquema como tablas regulares. Vea Tablas, Columnas de la tabla y Procedimientos almacenados.

Mesas¶

La lista de tablas se recupera dinámicamente de su cuenta de Azure, de modo que cualquier adición o eliminación se refleja inmediatamente cuando se conecta con el conector. Puede usar Crear tabla procedimiento almacenado* para crear una nueva tabla.

Las tablas de Azure requieren una clave de partición y una clave de fila. Ambos deberán configurarse para todas las consultas además de las consultas SELECT.

Columnas de la Tabla¶

Dado que las tablas de Azure Table Storage no tienen esquema, el conector ofrece los siguientes dos mecanismos para descubrir el esquema.

Esquemas Dinámicos¶

Las columnas de una tabla se determinan dinámicamente al escanear los datos en las primeras filas. Puede ajustar el número de filas que se utilizan modificando el RowScanDepth propiedad. Cuando TypeDetectionScheme está configurado en "RowScan", el escaneo de filas también determina el tipo de datos. La siguiente tabla muestra cómo se modelan en el conector los diferentes tipos de datos admitidos por Azure Table Storage.

Esquemas Estáticos¶

En lugar de usar esquemas descubiertos dinámicamente, puede definir sus propios esquemas. Esto le dará más control sobre las columnas proyectadas y también le permitirá definir manualmente los tipos de datos. Consulte el esquema de muestra incluido con el conector para definir su propio esquema. Simplemente puede cambiar el nombre del archivo de esquema de muestra, que debe coincidir con el nombre de la tabla de Azure Table Storage, y editar la lista de columnas para usarla en su propia tabla.

Operaciones Sin Esquema¶

El esquema de la tabla es necesario para recuperar datos, ya sea que los defina manualmente o los obtenga dinámicamente. Sin embargo, se pueden insertar, actualizar o eliminar datos de columnas que no existen en el esquema. Las columnas que aún no existen en el esquema de la tabla tendrán sus tipos de datos establecidos en Cadena.

Procedimientos Almacenados¶

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

Jitterbit Connector para Procedimientos Almacenados de Azure Table Storage¶

CreateEntityWithTypesCreateEntityWithTypes¶

Crea un nuevo registro con los tipos de datos dados. Si no se encuentra una columna en una entidad existente, deberá usar este procedimiento para establecer el tipo de propiedad en algo que no sea una cadena.

Note: Este procedimiento hace uso de indexed parameters. Estos parámetros de entrada se indican con un # carácter al final de sus nombres.

Los parámetros indexados facilitan el suministro de múltiples instancias de un solo parámetro como entradas para el procedimiento.

Supongamos que hay un parámetro de entrada llamado Param#. Ingrese múltiples instancias de un parámetro indexado como este:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Aporte¶

Columnas del Conjunto de Resultados¶

CrearEsquema¶

Crea un archivo de esquema para la tabla o vista especificada.

Aporte¶

Columnas del Conjunto de Resultados¶

Crear Mesa¶

Crea una nueva tabla en el sistema de Azure.

Aporte¶

Columnas del Conjunto de Resultados¶

Mesa Plegable¶

Quita una tabla existente en el sistema de Azure.

Aporte¶

Columnas del Conjunto de Resultados¶

Tablas del Sistema¶

Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.

Tablas de Esquema¶

Las siguientes tablas devuelven metadatos de base de datos para Azure Table Storage:

• sys_catalogs: enumera las bases de datos disponibles.
• sys_schemas: enumera los esquemas disponibles.
• sys_tablas: enumera las tablas y vistas disponibles.
• sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
• procedimientos_sys: describe los procedimientos almacenados disponibles.
• parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
• sys_keycolumns: describe las claves principal y externa.
• índices_sys: Describe los índices disponibles.

Tablas de Fuentes de Datos¶

Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:

• sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
• sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.

Tablas de Información de Consulta¶

La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:

• identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.

Sys_catalogs¶

Enumera las bases de datos disponibles.

La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:

SELECT * FROM sys_catalogs

Columnas¶

Sys_schemas¶

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas¶

Sys_tables¶

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas¶

Sys_tablecolumns¶

Describe las columnas de las tablas y vistas disponibles.

La siguiente consultar devuelve las columnas y los tipos de datos de la tabla NorthwindProducts:

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

Columnas¶

Sys_procedimientos¶

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures

Columnas¶

Sys_procedureparameters¶

Describe procedimiento almacenado* parámetros.

La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado CreateTable:

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

Columnas¶

Sys_keycolumns¶

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

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

Columnas¶

Sys_foreignkeys¶

Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Columnas¶

Sys_indexes¶

Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.

La siguiente consultar recupera todos los índices que no son claves principales:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Columnas¶

Sys_connection_props¶

Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.

Al consultar esta tabla, se debe usar la cadena de conexión de configuración:

jdbc:cdata:azuretables:config:

Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.

La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:

SELECT * FROM sys_connection_props WHERE Value <> ''

Columnas¶

Sys_sqlinfo¶

Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.

Procesamiento Colaborativo de Consultas¶

Al trabajar con fuentes de datos que no admiten SQL-92, puede consultar la vista sys_sqlinfo para determinar las capacidades de consultar de las APIs subyacentes, expresadas en sintaxis SQL. El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT al servidor y luego procesa el resto de la consultar en la memoria.

Descubrimiento de las Capacidades SELECT de la Fuente de Datos¶

A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.

La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte el Modelo de datos para obtener más información.

Columnas¶

Sys_identidad¶

Devuelve información sobre los intentos de modificación.

La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:

SELECT * FROM sys_identity

Columnas¶

Asignación de Tipos de Datos¶

Asignaciones de Tipos de Datos¶

El conector asigna tipos del origen de datos al tipo de datos correspondiente disponible en el esquema. La siguiente tabla documenta estas asignaciones.

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

SSL

Esquema

Misceláneas

Autenticación¶

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

Cuenta¶

El nombre de la cuenta de almacenamiento de Windows Azure.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El nombre de la cuenta de almacenamiento de Windows Azure. Para acceder a sus cuentas de almacenamiento de Azure o crear una, inicie sesión en Azure Portal. Haga clic en Cuentas de almacenamiento en el menú de servicios de la izquierda.

Si Backend está configurado en AzureStack, configure la cuenta como el alojar completo para sus datos. Por ejemplo: <cuenta>.nm.azs.sandia.gov.

Si Backend está configurado en Emulador, configure la Cuenta como el alojar completo. Por ejemplo: http://127.0.0.1:10002/devstoreaccount1.

Usar SSL¶

Este campo establece si SSL está habilitado. El defecto es cierto.

Tipo de Datos¶

bool

Valor por Defecto¶

true

Observaciones¶

Este campo establece si SSL está habilitado. El defecto es cierto.

Llave de Acceso¶

La clave para la cuenta de almacenamiento.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Para obtener la clave de acceso, inicie sesión en Azure Portal y haga clic en Cuentas de almacenamiento en el menú de servicios de la izquierda para enumerar las cuentas de almacenamiento. Seleccione una cuenta de almacenamiento y haga clic en Claves de acceso en la sección Configuración. Se puede utilizar la tecla 1 o la tecla 2.

Si utiliza CosmosDB como Backend, en su lugar, vaya al servicio de Cosmos DB y seleccione su cuenta de Azure Cosmos DB. En el menú de recursos, vaya a la página Cadena de conexión. Busque el valor PRIMARY KEY y establezca AccessKey en este valor.

AuthScheme¶

El esquema utilizado para la autenticación. Las entradas aceptadas son AccessToken y SharedAccessSignature.

Valores Posibles¶

AccessToken, SharedAccessSignature

Tipo de Datos¶

string

Valor por Defecto¶

"SharedAccessSignature"

Observaciones¶

Junto con Cuenta, este campo se utiliza para autenticarse en el servicio. El valor predeterminado es AccessToken:

• AccessToken: Indica que la autenticación se realizará a través de AccessKey y Cuenta.
• SharedAccessSignature: indica que la autenticación se realizará a través de SharedAccessSignature y Cuenta. Generalmente Tablas también debe establecerse.

Back-end¶

El backend donde se almacenan los datos.

Valores Posibles¶

AzureStack, CosmosDB, Storage, Emulator

Tipo de Datos¶

string

Valor por Defecto¶

"Storage"

Observaciones¶

Los datos se pueden recuperar desde el repositorio clásico de Azure Table Storage, Azure Storage Emulator o se pueden recuperar desde CosmosDB. Como alternativa, puede especificar AzureStack si usa Azure Stack Hub. Si elige hacerlo, especifique la Cuenta como el alojar completo para sus datos. Por ejemplo: <cuenta>.nm.azs.sandia.gov.

Si elige Emulador, especifique la Cuenta y Firma de acceso compartido propiedad de conexión.

SharedAccessFirma¶

Una firma de clave de acceso compartido que se puede utilizar para la autenticación.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Una firma de acceso compartido. Se puede usar en lugar de una AccessKey para acceder a los recursos.

SSL¶

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

SSLServerCert¶

El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Si usa una conexión TLS/SSL, esta propiedad se puede usar para especificar el certificado TLS/SSL que se aceptará del servidor. Se rechaza cualquier otro certificado que no sea de confianza para la máquina.

Esta propiedad puede tomar las siguientes formas:

Si no se especifica, se acepta cualquier certificado en el que confíe la máquina.

La máquina valida los certificados como confiables según el almacén de confianza del sistema. El almacén de confianza utilizado es el valor 'javax.net.ssl.trustStore' especificado para el sistema. Si no se especifica ningún valor para esta propiedad, se utiliza el almacén de confianza predeterminado de Java (por ejemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar que acepta todos los certificados. Tenga en cuenta que esto no se recomienda debido a problemas de seguridad.

Esquema¶

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

Ubicación¶

Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.

Tipo de Datos¶

string

Valor por Defecto¶

"%APPDATA%\\\AzureTables Data Provider\\Schema"

Observaciones¶

La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\\AzureTables Data Provider\Schema" con %APPDATA% estando configurado en el directorio de configuración del usuario:

Esquemas Navegables¶

Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.

Puntos de Vista¶

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

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Mesas¶

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

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Al usar SharedAccessSignature, en general el Tables debe establecerse para especificar para qué recurso es la firma.

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

Misceláneas¶

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

Generar Archivos de Esquema¶

Indica la preferencia del usuario en cuanto a cuándo deben generarse y guardarse los esquemas.

Valores Posibles¶

Never, OnUse, OnStart, OnCreate

Tipo de Datos¶

string

Valor por Defecto¶

"Never"

Observaciones¶

Esta propiedad genera esquemas en archivos .rsd en la ruta especificada por Ubicación.

Los ajustes disponibles son los siguientes:

• Nunca: nunca se generará un archivo de esquema.
• OnUse: se generará un archivo de esquema la primera vez que se haga referencia a una tabla, siempre que el archivo de esquema para la tabla aún no exista.
• OnStart: se generará un archivo de esquema en el momento de la conexión para las tablas que actualmente no tienen un archivo de esquema.
• OnCreate: se generará un archivo de esquema al ejecutar una consultar SQL CREATE TABLE.

Tenga en cuenta que si desea volver a generar un archivo, primero deberá eliminarlo.

Generar Esquemas con SQL¶

Cuando configuras GenerateSchemaFiles a OnUse, el conector genera esquemas a medida que ejecuta consultas SELECT. Los esquemas se generan para cada tabla a la que se hace referencia en la consultar.

Cuando configuras GenerateSchemaFiles a OnCreate, los esquemas solo se generan cuando se ejecuta una consultar CREATE TABLE.

Generar Esquemas en la Conexión¶

Otra forma de usar esta propiedad es obtener esquemas para cada tabla en su base de datos cuando se conecta. Para hacerlo, establezca GenerateSchemaFiles a OnStart y conectar.

Filas Máximas¶

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Tipo de Datos¶

int

Valor por Defecto¶

-1

Observaciones¶

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Otro¶

Estas propiedades ocultas se usan solo en casos de uso específicos.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.

Especifique varias propiedades en una lista separada por punto y coma.

Integración y Formateo¶

Pseudocolumnas¶

Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".

FilaExploraciónProfundidad¶

El número máximo de filas para escanear para buscar las columnas disponibles en una tabla.

Tipo de Datos¶

int

Valor por Defecto¶

50

Observaciones¶

Las columnas de una tabla deben determinarse escaneando las filas de la tabla. Este valor determina el número máximo de filas que se escanearán.

Establecer un valor alto puede disminuir el rendimiento. Establecer un valor bajo puede evitar que el tipo de datos se determine correctamente, especialmente cuando hay datos nulos.

Se Acabó el Tiempo¶

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

Tipo de Datos¶

int

Valor por Defecto¶

60

Observaciones¶

Si Timeout = 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.

Si Timeout caduca y la operación aún no se ha completado, el conector genera una excepción.

TipoDetecciónEsquema¶

Determina cómo determinar el tipo de datos de las columnas.

Valores Posibles¶

None, RowScan

Tipo de Datos¶

string

Valor por Defecto¶

"RowScan"

Observaciones¶