Attention : Este código requiere privilegios de administrador.
La macro `%mm_updatestpservertype` está diseñada para modificar el tipo de servidor de un proceso almacenado de SAS© Viya™ 4 existente. Requiere dos parámetros: `target` (la ruta completa al proceso almacenado) y `type` (ya sea 'WKS' para un servidor Workspace, o 'STP' para un servidor Stored Process).
La ejecución de la macro se desarrolla en varias etapas:
1. Verificación de existencia: Un bloque `DATA _NULL_` utiliza la función `metadata_pathobj` para consultar los metadatos de SAS© y verificar si un proceso almacenado existe en la ruta `target` y para extraer su URI y tipo. Si el objeto no se identifica como un proceso almacenado, la macro se detiene con un mensaje de advertencia.
2. Determinación del nuevo tipo: Se utiliza una lógica de macro condicional `%if %then %let` para traducir el parámetro `type` en un valor apropiado ('Wks' o 'Sps') para los metadatos.
3. Actualización de metadatos: Un segundo bloque `DATA _NULL_` recorre las asociaciones de metadatos (`Notes`) de la URI del proceso almacenado utilizando `metadata_getnasn` y `metadata_getattr`. Cuando se encuentra la nota 'Stored Process', la función `METADATA_SETATTR` se utiliza para modificar su atributo 'StoredText'. Este atributo contiene una estructura XML que se actualiza para incluir el `LogicalServerType` elegido. El parámetro `OtherAllowed="false"` también se define.
4. Reporte del resultado: Finalmente, la macro muestra un mensaje de éxito o error en el log de SAS©, basado en el resultado de la operación de actualización de metadatos. Esta operación se considera administrativa ya que modifica la configuración de los procesos almacenados a nivel del servidor de metadatos.
La ejecución de la macro se desarrolla en varias etapas:
1. Verificación de existencia: Un bloque `DATA _NULL_` utiliza la función `metadata_pathobj` para consultar los metadatos de SAS© y verificar si un proceso almacenado existe en la ruta `target` y para extraer su URI y tipo. Si el objeto no se identifica como un proceso almacenado, la macro se detiene con un mensaje de advertencia.
2. Determinación del nuevo tipo: Se utiliza una lógica de macro condicional `%if %then %let` para traducir el parámetro `type` en un valor apropiado ('Wks' o 'Sps') para los metadatos.
3. Actualización de metadatos: Un segundo bloque `DATA _NULL_` recorre las asociaciones de metadatos (`Notes`) de la URI del proceso almacenado utilizando `metadata_getnasn` y `metadata_getattr`. Cuando se encuentra la nota 'Stored Process', la función `METADATA_SETATTR` se utiliza para modificar su atributo 'StoredText'. Este atributo contiene una estructura XML que se actualiza para incluir el `LogicalServerType` elegido. El parámetro `OtherAllowed="false"` también se define.
4. Reporte del resultado: Finalmente, la macro muestra un mensaje de éxito o error en el log de SAS©, basado en el resultado de la operación de actualización de metadatos. Esta operación se considera administrativa ya que modifica la configuración de los procesos almacenados a nivel del servidor de metadatos.
Análisis de datos
Type : AUCUNE
La macro no utiliza datos de SAS (tablas o conjuntos de datos) como fuente. Opera directamente en el sistema de metadatos de SAS, consultando y modificando las definiciones de los procesos almacenados. Por lo tanto, no hay dependencia de datos externos o bibliotecas específicas para su ejecución funcional.
1 Bloque de código
DATA STEP
Explicación :
Este bloque `DATA _NULL_` se utiliza para interactuar con el servidor de metadatos de SAS. La función `metadata_pathobj` intenta localizar el proceso almacenado especificado por el parámetro `target` y extraer su tipo (`cmtype`) y su URI (`stpuri`). Esta información se almacena luego en variables macro locales. Se realiza una verificación para asegurar que el objeto encontrado es un 'StoredProcess'. Si no es el caso, se emite una advertencia y la macro finaliza.
Este bloque `DATA _NULL_` se utiliza para interactuar con el servidor de metadatos de SAS. La función `metadata_pathobj` intenta localizar el proceso almacenado especificado por el parámetro `target` y extraer su tipo (`cmtype`) y su URI (`stpuri`). Esta información se almacena luego en variables macro locales. Se realiza una verificación para asegurar que el objeto encontrado es un 'StoredProcess'. Si no es el caso, se emite una advertencia y la macro finaliza.
¡Copiado!
| 1 | DATA _null_; |
| 2 | LENGTH type uri $256; |
| 3 | rc=metadata_pathobj("","&target",'StoredProcess',type,uri); |
| 4 | call symputx('cmtype',type,'l'); |
| 5 | call symputx('stpuri',uri,'l'); |
| 6 | RUN; |
| 7 | %IF &cmtype ne ClassifierMap %THEN %DO; |
| 8 | %put %str(WARN)ING: No Stored Process found at ⌖ |
| 9 | %return; |
| 10 | %END; |
2 Bloque de código
MACRO LOGIQUE
Explicación :
Este simple bloque lógico de macro determina el valor del tipo de servidor a definir. Si el parámetro `type` es 'WKS', la variable macro `newtype` se establece en 'Wks'. De lo contrario, se establece en 'Sps'. Esta variable se utilizará más adelante para construir la cadena XML de actualización de metadatos.
Este simple bloque lógico de macro determina el valor del tipo de servidor a definir. Si el parámetro `type` es 'WKS', la variable macro `newtype` se establece en 'Wks'. De lo contrario, se establece en 'Sps'. Esta variable se utilizará más adelante para construir la cadena XML de actualización de metadatos.
¡Copiado!
| 1 | %IF &type=WKS %THEN %let newtype=Wks; |
| 2 | %ELSE %let newtype=Sps; |
| 3 |
3 Bloque de código
DATA STEP
Explicación :
Este segundo bloque `DATA _NULL_` es el núcleo de la lógica de actualización. Itera sobre las notas asociadas a la URI del proceso almacenado (`stpuri`) utilizando `metadata_getnasn`. Busca específicamente la nota cuyo nombre es 'Stored Process'. Una vez encontrada, la función `METADATA_SETATTR` se utiliza para modificar su atributo 'StoredText'. Este atributo se actualiza con una nueva cadena XML que define el `LogicalServerType` del proceso almacenado utilizando la variable macro `&newtype` determinada previamente. El éxito de esta operación se registra en la variable macro `result`.
Este segundo bloque `DATA _NULL_` es el núcleo de la lógica de actualización. Itera sobre las notas asociadas a la URI del proceso almacenado (`stpuri`) utilizando `metadata_getnasn`. Busca específicamente la nota cuyo nombre es 'Stored Process'. Una vez encontrada, la función `METADATA_SETATTR` se utiliza para modificar su atributo 'StoredText'. Este atributo se actualiza con una nueva cadena XML que define el `LogicalServerType` del proceso almacenado utilizando la variable macro `&newtype` determinada previamente. El éxito de esta operación se registra en la variable macro `result`.
¡Copiado!
| 1 | DATA _null_; |
| 2 | LENGTH uri name value $256; |
| 3 | n=1; |
| 4 | DO while(metadata_getnasn("&stpuri","Notes",n,uri)>0); |
| 5 | n+1; |
| 6 | rc=metadata_getattr(uri,"Name",name); |
| 7 | IF name='Stored Process' THEN DO; |
| 8 | rc = METADATA_SETATTR(uri,'StoredText' |
| 9 | ,'<?xml version="1.0" encoding="UTF-8"?>' |
| 10 | !!'<StoredProcess><ServerContext LogicalServerType="'!!"&newtype" |
| 11 | !!'" OtherAllowed="false"/><ResultCapabilities Package="false" ' |
| 12 | !!' Streaming="true"/><OutputParameters/></StoredProcess>'); |
| 13 | IF rc=0 THEN call symputx('result','SUCCESS'); |
| 14 | stop; |
| 15 | END; |
| 16 | END; |
| 17 | RUN; |
4 Bloque de código
MACRO LOGIQUE
Explicación :
Este bloque final es una instrucción de macro condicional que muestra un mensaje en el log de SAS. Si la variable macro `result` es 'SUCCESS', se muestra un mensaje de confirmación, indicando que el tipo de servidor del proceso almacenado ha sido modificado. De lo contrario, se emite un mensaje de error general, señalando un problema durante la ejecución de la macro.
Este bloque final es una instrucción de macro condicional que muestra un mensaje en el log de SAS. Si la variable macro `result` es 'SUCCESS', se muestra un mensaje de confirmación, indicando que el tipo de servidor del proceso almacenado ha sido modificado. De lo contrario, se emite un mensaje de error general, señalando un problema durante la ejecución de la macro.
¡Copiado!
| 1 | %IF &RESULT=SUCCESS %THEN %put NOTE: SUCCESS: STP &target changed to &type type; |
| 2 | %ELSE %put %str(ERR)OR: Issue with &sysmacroname; |
| 3 |
Este material se proporciona "tal cual" por We Are Cas. No hay garantías, expresas o implícitas, en cuanto a la comerciabilidad o idoneidad para un propósito particular con respecto a los materiales o el código contenidos en este documento. We Are Cas no es responsable de los errores en este material tal como existe ahora o existirá, ni We Are Cas proporciona soporte técnico para el mismo.
Información de copyright : La información de derechos de autor se detecta en los archivos referenciados: 'Copyright (c) 2001-2006 Rodney Sparapani' (bajo licencia GNU General Public License) para _version.sas, y 'Copyright 2010-2023 HMS Analytical Software GmbH, http://www.analytical-software.de' (parte de SASUnit) para macro_without_brief_tag.sas. Estas referencias se incluyen en el bloque de ayuda de la macro principal.
Consejo del Experto
Simon
Expert SAS et fondateur.
« La macro %mm_updatestpservertype ilustra una técnica de administración avanzada: la modificación directa de la configuración de ejecución de un Stored Process. Aunque la descripción menciona SAS Viya 4, el código utiliza la Open Metadata Architecture (OMA) específica de SAS 9.x. Al manipular el atributo StoredText, estás instruyendo directamente al Object Spawner sobre cómo debe instanciar el motor de SAS para atender una petición.
Recomendaciones estratégicas y mejores prácticas
WKS vs. STP (SPS): La elección del tipo de servidor es vital para el rendimiento. WKS (Workspace Server) es ideal para procesos pesados con sesiones dedicadas, mientras que STP (Stored Process Server) utiliza un pool de sesiones multiusuario, proporcionando tiempos de respuesta más rápidos para peticiones frecuentes y ligeras.
El riesgo de sobreescribir StoredText: La función METADATA_SETATTR en este script inyecta una cadena XML predefinida. Atención: este método sobrescribe el atributo completo. Si tu Stored Process tenía configuraciones personalizadas (capacidades de resultado específicas, parámetros de entrada, etc.), estas se perderán. Un enfoque experto sería leer primero el XML existente y modificar únicamente el atributo LogicalServerType.
Persistencia de metadatos: A diferencia de los cambios realizados mediante la SAS Management Console, las modificaciones vía METADATA_SETATTR son inmediatas y permanentes en el repositorio. Realiza siempre un respaldo (SPK) del objeto antes de ejecutar macros de automatización que alteren atributos. »
Recomendaciones estratégicas y mejores prácticas
WKS vs. STP (SPS): La elección del tipo de servidor es vital para el rendimiento. WKS (Workspace Server) es ideal para procesos pesados con sesiones dedicadas, mientras que STP (Stored Process Server) utiliza un pool de sesiones multiusuario, proporcionando tiempos de respuesta más rápidos para peticiones frecuentes y ligeras.
El riesgo de sobreescribir StoredText: La función METADATA_SETATTR en este script inyecta una cadena XML predefinida. Atención: este método sobrescribe el atributo completo. Si tu Stored Process tenía configuraciones personalizadas (capacidades de resultado específicas, parámetros de entrada, etc.), estas se perderán. Un enfoque experto sería leer primero el XML existente y modificar únicamente el atributo LogicalServerType.
Persistencia de metadatos: A diferencia de los cambios realizados mediante la SAS Management Console, las modificaciones vía METADATA_SETATTR son inmediatas y permanentes en el repositorio. Realiza siempre un respaldo (SPK) del objeto antes de ejecutar macros de automatización que alteren atributos. »