Archivo de propiedades de entrada de fragmentación

El archivo de propiedades de entrada de fragmentación es un archivo que el usuario crea que se pasa al programa de utilidad di-parallel-process cuando se indexan fragmentos.

El archivo de propiedades de entrada de fragmentación contiene las siguientes secciones y propiedades:

Propiedades de sistema

Otros programas de utilidad comparten las propiedades de sistema. Por ejemplo, las contraseñas que son comunes entre los programas de utilidad.

PasswordFileDir: La ubicación de un archivo password.properties que el usuario crea que contiene las contraseñas cifradas por el programa de utilidad wcs_encrypt.

Propiedades de base de datos

Las propiedades de base de datos se utilizan para establecer conexiones de base de datos con el servidor de bases de datos. Todas las propiedades de base de datos empiezan con la palabra clave Database, seguida del nombre de propiedad, que está separada por un punto.

La lista siguiente muestra las propiedades de base de datos:

Database.dbType: El tipo de base de datos. Los valores aceptados son db2 o oracle.
Database.dbName: El nombre de la base de datos.
Database.dbHost: El nombre de host base de datos remota.
Database.dbServerPort: El número de puerto de base de datos remota.
Database.dbUser: El nombre de usuario de base de datos.
Database.dbSchemaName: El nombre del esquema de base de datos. Normalmente este valor es la versión en mayúsculas del nombre de usuario de base de datos.
Database.jdbcURL: URL JDBC de base de datos.
Database.jdbcDriverLocation: La ubicación de controlador JDBC de base de datos.
Database.jdbcDriverType: El tipo de controlador JDBC de base de datos.

Propiedades de preproceso e indexación globales

Las propiedades globales se utilizan para que todos los fragmentos las preprocesen e indexen, a no ser que el propio fragmento las sobrescriba. Todas las propiedades globales empiezan con la palabra clave Global, seguida del nombre de propiedad, que está separada por un punto.

Las propiedades globales se pueden agrupar en las categorías siguientes: propiedades del servidor, propiedades de preproceso y propiedades de indexación.

La lista siguiente muestra las propiedades de servidor globales:

Global.index-server-name: El nombre de host del servidor de búsqueda.
Global.index-server-port: El número de puerto de servidor de búsqueda.
Global.index-server-user: El nombre de usuario de servidor de búsqueda.

La lista siguiente muestra las propiedades de preproceso globales:

Global.preprocessing-locale

Un único valor de entorno local de preproceso que se debe preprocesar. El valor predeterminado es All, donde se preprocesan todos los entornos locales.

Se permite una lista separada por comas de entornos locales.

Global.auto-preprocess

Preprocesar automáticamente todos los fragmentos.

Global.preprocessing-drop-temp-table

Indica si se deben descartar tablas cuando se preprocesa el índice de búsqueda.

Si se pasa un valor de false, se utiliza una sentencia TRUNCATE en las tablas.

El valor predeterminado es true, que utiliza una sentencia DROP en las tablas.

Nota: Este parámetro solo soporta bases de datos DB2 9.7 o posterior, u Oracle.

Global.preprocessing-deepSequence

Opcional: Habilita el preproceso para la característica de secuenciación de búsqueda detallada.

El valor predeterminado es false.

Global.preprocessing-truncate-table-sql

Sobrescribe la sentencia de tabla TRUNCATE predeterminada.

Global.preprocessing-dir

La ruta a los archivos de XML de preproceso en el contenedor Utility Docker HCL Commerce.

Global.preprocessing-initial-global-table-dir

El XML de preproceso bajo esta ruta se procesa una sola vez antes de fragmentar. Esta ruta es la ubicación preferida para preprocesar las configuraciones para las tablas temporales iniciales que no es necesario fragmentar o crear varias veces.

Para reducir los esfuerzos de configuración del cliente, la fragmentación automática está soportada en HCL Commerce versión 9.0.0.5+ y está habilitada de forma predeterminada en versión 9.0.0.7+. Cuando esta característica está habilitada, el programa de utilidad de proceso paralelo puede dividir automáticamente la tabla de entrada CATENTRY en partes iguales por número de fila y crear tablas temporales basadas en esas partes. Los nombres de fragmento se generan automáticamente de acuerdo con el valor de number-of-shards, a partir de a. Por ejemplo, si number-of-shards es igual a 3, los fragmentos se denominarán A, B y C.

PRECAUCIÓN: No puede utilizar la fragmentación automática y los fragmentos especificados manualmente al mismo tiempo. Si lo hace, Global.locale no podrá sobrescribir index-core-name y index-core-dir de cada fragmento para el proceso de fragmentación, lo que dará como resultado un comportamiento imprevisible.

La lista siguiente muestra las propiedades de fragmentación automática:

Nota: La fragmentación automática es compatible con la fragmentación vertical y se recomienda la combinación.

Global.auto-shard

Marque para hacer fragmentación automática. En HCL Commerce versión 9.0.07+, esta propiedad está habilitada de forma predeterminada.

Global.number-of-shards

Número de fragmentos en los que dividir el índice. El rango de valores permitidos es de 1 a 26. En la versión 9.0.0.7+, el valor predeterminado es 3.

Global.preprocessing-shard-entry-table

Tabla o vista de entrada de fragmento. Si no se establece este valor, la tabla CATENTRY se procesa como la tabla de entrada predeterminada.

Global.locale.unstructured-index-core-name

Nombre que se va a utilizar para alterar temporalmente unstructured-index-core-name.

Global.locale.unstructured-index-core-dir

Directorio que se va a utilizar para alterar temporalmente unstructured-index-core-dir.

Global.locale.structured-index-core-name

Nombre que se va a utilizar para alterar temporalmente structured-index-core-name.

Global.locale.structured-index-core-dir

Si Global.auto-index se establece en true, las configuraciones de Global.locale... sobrescriben la grabación de cada configuración de index-core-name y index-core-dir de núcleo de fragmento en las propiedades de fragmento horizontal. locale es un entorno local soportado, por ejemplo en_US o fr_FR. Los anteriores index-core-name e index-core-dir pueden añadirse automáticamente con el nombre de fragmento.

Por ejemplo, si el cliente ha establecido el número de fragmentos a 3 con las configuraciones siguientes:

 Global.en_US.unstructured-index-core-name=MC_10001_CatalogEntry_Unstructured_en_US
Global.en_US.unstructured-index-core-dir=/search/index/solr/MC_10001/en_US/Unstructured
Global.en_US.structured-index-core-name=MC_10001_CatalogEntry_en_US
Global.en_US.structured-index-core-dir=/search/index/solr/MC_10001/en_US/CatalogEntry

A continuación, los fragmentos A, B y C se crean automáticamente. Para el índice automático, los valores son los siguientes.

Unstructured-index-core-name del fragmento A es MC_10001_CatalogEntry_Unstructured_en_US_A. Su unstructured-index-core-dir es /search/index/solr/MC_10001/en_US/Unstructured_A/. Su structured-index-core-name es MC_10001_CatalogEntry_en_US_A, y su structured-index-core-dir es /search/index/solr/MC_10001/en_US/CatalogEntry_A/.
Unstructured-index-core-name del fragmento B es MC_10001_CatalogEntry_Unstructured_en_US_B. Su unstructured-index-core-dir es /search/index/solr/MC_10001/en_US/Unstructured_B/. Su structured-index-core-name es MC_10001_CatalogEntry_en_US_B, y su structured-index-core-dir es /search/index/solr/MC_10001/en_US/CatalogEntry_B/.
Unstructured-index-core-name del fragmento C es MC_10001_CatalogEntry_Unstructured_en_US_C. Su unstructured-index-core-dir es /search/index/solr/MC_10001/en_US/Unstructured_C/. Su structured-index-core-name es MC_10001_CatalogEntry_en_US_C, y su structured-index-core-dir es /search/index/solr/MC_10001/en_US/CatalogEntry_C/.

La lista siguiente muestra las propiedades de indexación globales:

Global.auto-index: Iniciar automáticamente la indexación de fragmentos después de que se preprocesen.
Global.create-core: Cree el núcleo de fragmento en el archivo solr.xml si no existe.
Global.unload-core: Descargue el núcleo de fragmento del archivo solr.xml si no existe.
Gloabl.index-status-Interval: El rango de tiempo para supervisar el proceso de indexación. El valor predeterminado es 10000.
Global.auto-merge-index: Fusionar automáticamente el índice en el servidor maestro después de que se complete toda la indexación de fragmento.

Propiedades de servidor de búsqueda maestro

Normalmente sólo hay un conjunto de propiedades maestras. Empiezan con la palabra clave Master, seguida de la palabra clave common o el nombre de entorno local (por ejemplo, en_US), seguidos por el nombre de propiedad, que está separado por un punto.

Las propiedades maestras deben incluir al menos las propiedades específicas de maestro. Sólo las propiedades de servidor global se pueden sobrescribir en las propiedades maestras. De lo contrario, si no se redefinen, se utilizan las propiedades globales.

Nota: Las propiedades siguientes utilizan el entorno local en_US con los fragmentos A y C como ejemplo. Configure el archivo de propiedades de entrada de fragmentación en el entorno local y los tipos de fragmento que está utilizando.

Master.en_US.structured-index-core-name
Master.en_US.unstructured-index-core-name: Los núcleos de índice maestro donde se fusionan todos los datos de fragmento.

Propiedades de fragmento horizontal

Normalmente hay un conjunto de propiedades de fragmentos horizontales para cada fragmento horizontal. Las propiedades de fragmento horizontal empiezan con la palabra clave Shard, seguida del nombre de fragmento, seguido de la palabra clave common o del nombre de entorno local, seguido del nombre de propiedad, todos separados por puntos.

Las propiedades de fragmento horizontal deben incluir al menos las propiedades específicas del fragmento horizontal. Todas las propiedades globales se pueden sobrescribir en el fragmento horizontal, excepto auto-merge-index. Si no se redefinen las propiedades, se utilizan las propiedades globales.

La lista siguiente muestra las propiedades específicas de fragmento horizontal, utilizando el fragmento A como ejemplo:

Shard.A.common.preprocessing-dir: La ruta a los archivos de XML de preproceso en el contenedor Utility Docker HCL Commerce. Esta propiedad es común y no se puede sobrescribir.
Shard.A.common.preprocessing-start-range-value
Shard.A.common.preprocessing-end-range-value: Los valores inicial y final de rango de fragmento horizontal.
Shard.A.common.configuration-type: El tipo de fragmento a configurar. Por ejemplo, horizontal o vertical. Cuando hay una combinación de tipos de fragmento horizontal y vertical, esta propiedad debe establecerse de este modo. En este caso, horizontal.
Shard.A.en_US.unstructured-index-core-name
Shard.A.en_US.unstructured-index-core-dir
Shard.A.en_US.structured-index-core-name
Shard.A.en_US.structured-index-core-dir: Los directorios y nombres de núcleo estructurados y no estructurados de fragmento.

Propiedades de fragmento vertical

Normalmente hay un conjunto de propiedades de fragmentos verticales para cada fragmento vertical. Las propiedades de fragmento vertical empiezan con la palabra clave Shard, seguida del nombre de fragmento, la palabra clave common o el nombre de entorno local, seguidos del nombre de propiedad, todo separado por puntos.

Las propiedades de fragmento vertical deben incluir al menos las propiedades específicas de fragmento vertical. Sólo se pueden sobrescribir las propiedades de preproceso globales en el fragmento vertical. De lo contrario, si no se redefinen, se utilizan las propiedades globales.

La lista siguiente muestra las propiedades específicas de fragmento vertical, utilizando el fragmento V como ejemplo:

Shard.V.common.preprocessing-dir: La ruta a los archivos de XML de preproceso en el contenedor Utility Docker HCL Commerce. Esta propiedad es común y no se puede sobrescribir.
Shard.V.common.configuration-type: El tipo de fragmento a configurar. Por ejemplo, horizontal o vertical. Cuando hay una combinación de tipos de fragmento horizontal y vertical, esta propiedad debe establecerse de este modo. En este caso, vertical.

Alteración de propiedades

Para alterar una propiedad global maestra o de fragmento, utilice el siguiente convenio para sobrescribirla a nivel común:


Master.common.index-server-name=localhost
Shard.A.common.index-server-name=localhost

Para alterar una propiedad global maestra o de fragmento, utilice el siguiente convenio para sobrescribirla a nivel de entorno local:


Master.en_US.index-server-name=localhost
Shard.A.en_US.index-server-name=localhost

Archivo de propiedades de muestra

La imagen de Utility Docker contiene dos archivos de propiedades de ejemplo. El archivo de ejemplo di-parallel-process.properties utiliza el entorno local en_US con los fragmentos A, B y C. Estas definiciones de fragmento se comentan en favor de la fragmentación automática, pero se han mantenido como ejemplos porque todavía se da soporte a la fragmentación manual.

Puede encontrar los archivos de muestra en el directorio /opt/WebSphere/CommerceServer90/properties/parallelprocess/.

di-parallel-process.properties: El archivo de propiedades de entrada de fragmentación de ejemplo para un sistema operativo Linux que usa DB2. Consulte el archivo de configuración di-parallel-process.properties más reciente en el contenedor Docker del programa de utilidad de HCL Commerce si está utilizando la base de datos Oracle.
password.properties: El archivo de propiedades de contraseña de ejemplo, referenciado por el archivo de propiedades de entrada de fragmentación de ejemplo. Contiene las contraseñas cifradas por el programa de utilidad wcs_encrypt.