nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

¿Qué es Egdbhealth?

DannyKrouk_ps

Nota: Esta publicación del blog es la primera de una serie de tres publicaciones planificadas sobre egdbhealth. La segunda en la serie abordará cómo usar la herramienta para evaluar la salud de un Enterprise Geodatabase. La tercera en la serie tratará sobre el uso de egdbhealth en un contexto de diseño de sistemas.

Introducción

Egdbhealth es una herramienta para reportar sobre varias características de Enterprise Geodatabases (eGDBes). Proporciona información descriptiva sobre el contenido del eGDB y proporciona información evaluativa sobre el eGDB. La información evaluativa es el propósito principal de la herramienta; para revelar problemas/desafíos existentes o latentes con el eGDB. La herramienta funciona con eGDBes respaldados por Oracle, PostgreSQL y SQL Server.

Instalación y Ejecución

Aunque no es una extensión de ArcGIS Monitor, egdbhealth está disponible para descargar desde la Galería de ArcGIS Monitor: https://arcgismonitor.maps.arcgis.com/home/item.html?id=f343f6b2bbcf434386f6dde1e468e7ab.

Instalación y Requisitos Previos

Para instalar, simplemente descargue el archivo .zip y extraiga los archivos a un directorio de su elección.

Hay algunos requisitos previos para ejecutar egdbhealth. Esas consideraciones se discuten en la documentación en el archivo .zip (egdbhealth_README.docx). Pero, a un nivel alto, los requisitos previos son:

Necesita un cliente de base de datos para el tipo de base de datos (Oracle, PostgreSQL o SQL Server) al que se está conectando (http://desktop.arcgis.com/en/arcmap/latest/manage-data/databases/database-clients.htm).
Si está utilizando "Operating System Authentication" con SQL Server, y su eGDB es propiedad de "dbo" (en lugar de "sde"), debe ejecutar egdbhealth como un usuario de Windows que sea dbo. En otras palabras, debe conectarse como el "Geodatabase Administrator" (http://desktop.arcgis.com/en/arcmap/latest/manage-data/gdbs-in-sql-server/geodatabase-administrator-sqlserver.htm). Debe conectarse como el Geodatabase Administrator con Oracle o PostgreSQL, pero eso generalmente significa conectarse como el usuario llamado "sde".
Si se conecta a Oracle o PostgreSQL, debe haber habilitado la biblioteca de tipos ST_Geometry (http://desktop.arcgis.com/en/arcmap/latest/manage-data/databases/add-the-st-geometry-type-to-an-oracle-database.htm o http://desktop.arcgis.com/en/arcmap/latest/manage-data/databases/add-the-st-geometry-type-to-a-postgresql-database.htm).

Ejecución

Doble clic en egdbhealth.exe abrirá una ventana de comandos y un formulario de Windows.

Siga las indicaciones en el formulario para completar la información de conexión para su base de datos. Las sugerencias emergentes proporcionan pistas sobre la naturaleza de la información requerida. Pero, en principio, la información es la misma que proporcionaría a ArcGIS para conectarse a la base de datos como el "Geodatabase Administrator."

Interfaz Gráfica de Usuario

El botón "Test" intentará confirmar que puede conectarse, con los privilegios requeridos, al eGDB. Si la prueba es exitosa, el botón "Test" se convertirá en un botón "Run". Hacer clic en ese cerrará el formulario y comenzará a ejecutar la herramienta en la ventana de comandos.

Cuando la herramienta termine, abrirá el subdirectorio "output" que contendrá cinco archivos de salida:

Un archivo HTML que contiene metadatos sobre el eGDB consultado y el objetivo RDBMS y cómo se realiza la conexión.
Un archivo Excel "Context" que contiene información descriptiva sobre el eGDB y el objetivo RDBMS.
Un archivo Excel "Expert" que contiene información evaluativa, clasificada como "Critical", "Warning", e "Information".
Un archivo png que representa el árbol de versiones.
Un archivo png que representa el árbol de estados.

Presentando la Salida

Un ejemplo de los archivos de salida se muestra a continuación:

Archivos de salida

Los archivos llevarán el "GDB Friendly Name" que especificó en el formulario (en este ejemplo, "SQL_GIS").

El Archivo Expert Excel

El archivo Expert Excel es el principal artefacto informativo. Proporciona la información evaluativa sobre el sistema eGDB objetivo. Por ejemplo, si el eGDB no ha sido comprimido recientemente, habrá una evaluación que reportará esto como una preocupación.

El archivo tiene una hoja resumen que proporciona una visión general de las evaluaciones. Las evaluaciones están categorizadas por tema general (primera columna, "Category") y clasificadas (columnas Critical, Warning e Informational) para que pueda priorizar su revisión de la información.

La columna Description explica brevemente el propósito de la evaluación. Donde hay un marcador rojo en la celda Description, hay una sugerencia emergente que proporciona aún más información sobre lo que se está evaluando.

Hoja Resumen del archivo Expert Excel

Algunos hallazgos no tienen registros para reportar. Por ejemplo, si no hay problema con un tipo dado de Consistencia del Geodatabase, no habrá registros. Sin embargo, muchos hallazgos tendrán algún número de registros con varias clasificaciones. En esos casos, el Nombre (segunda columna) tendrá un hipervínculo a la hoja en el libro que tiene los registros detallados del hallazgo.

El Archivo Context Excel

El archivo Context Excel es similar en estructura pero carece de las columnas clasificatorias expertas (Critical-Warning-Informational). La información es más descriptiva y menos evaluativa. Por ejemplo, en este archivo puede encontrar una lista de todos los Dominios del Geodatabase y las ObjectClasses a las que están relacionados. Esa información no es ni buena ni mala (es decir, no evaluativa). Pero puede ser útil saberlo.

Hoja Resumen del archivo Context Excel

Los registros resaltados en verde tienen sentencias SQL que puede ejecutar para obtener información adicional, según corresponda. Usualmente, estas sentencias SQL son demasiado costosas para ejecutarse sobre todo el contenido del eGDB.

Pero, alguien familiarizado con el eGDB y los problemas que tiene puede tener ideas sobre qué consultas serían útiles ejecutar de todos modos. Por ejemplo, la hoja "SqlGeomTypeSizeSql" tiene una consulta SQL para cada FeatureClass en el eGDB. Si ejecutas una de estas consultas, reportará los tamaños de las geometrías en un FeatureClass. Esta es una operación lo suficientemente costosa como para que no sea apropiado ejecutarla en todos los FeatureClasses por defecto. Pero, si hay un FeatureClass que tiene un problema de rendimiento, puede ser útil que ejecutes la consulta para ese FeatureClass para examinar los tamaños de sus geometrías.<\/P>

<\/P>

Los PNGes<\/H3>Los archivos PNG (un diagrama de árbol de versiones y un diagrama de árbol de estados) suelen ser de interés si tu eGDB tiene datos que han sido registrados como versionados.<\/P> <\/P>El gráfico del árbol de versiones ilustra la jerarquía del árbol de versiones. La codificación por colores (rojo-amarillo-verde) indica el grado relativo de "obsolescencia", o cuánto tiempo ha pasado desde que la versión fue editada o reconciliada.<\/P> <\/P><\/P> <\/P>El esquema del árbol de estados ilustra la profundidad y estructura del árbol de estados (que es la estructura detallada sobre la cual se basa el árbol de versiones). La versión Default se muestra en rojo y "State Zero" se muestra en verde. Cuanto más separados estén estos nodos, más costoso es para la base de datos devolver información sobre la versión Default (la versión más comúnmente usada en la mayoría de los sistemas).<\/P> <\/P><\/P> <\/P>El HTML<\/H3>El HTML proporciona información general sobre el eGDB, RDBMS y la máquina que es el objetivo de la evaluación. Puede ser solo de interés pasajero en muchos casos.<\/P> <\/P><\/P> <\/P>Resumen<\/H2>Este artículo ha descrito el propósito de egdbhealth, cómo ejecutarlo y cuáles son sus salidas. Como las salidas de la herramienta contienen bastante información técnica, otros artículos abordarán cómo usar las salidas para (a) entender y mejorar la salud del eGDB (b) diseñar sistemas GIS.<\/SPAN><\/P> <\/P>Espero que esto te sea útil, no dudes en publicar tus preguntas aquí: https:\/\/community.esri.com\/thread\/231451-arcgis-architecture-series-tools-of-an-architect<\/SPAN><\/A><\/SPAN><\/P> <\/SPAN><\/P>Nota:<\/EM><\/STRONG> Los contenidos presentados arriba son recomendaciones que típicamente mejorarán el rendimiento en muchos escenarios. Sin embargo, en algunos casos, estas recomendaciones pueden no producir mejores resultados de rendimiento, en cuyo caso, puede ser necesario realizar pruebas adicionales de rendimiento y modificaciones en la configuración del sistema.<\/EM><\/SPAN><\/P>

Encuentra más publicaciones etiquetadas con

Comentarios

Anonymous User

@DannyKrouk The download link no longer works.

DannyKrouk_ps

Yes, sorry about that. I don't know what is going on. This link should work: https://arcgismonitor.maps.arcgis.com/home/item.html?id=f343f6b2bbcf434386f6dde1e468e7ab. Now, I have to figure out how to edit this crazy blog when the system does not recognize my original account. Sigh ...

DannyKrouk_ps

The link is fixed now. 🙂

Sjavvaji

Hello, I am attempting to download the egdbhealth from the below-mentioned link, but I was unable to do so even after using multiple logins. I am attaching the error below; can anyone assist me in resolving this issue?

link: https://arcgismonitor.maps.arcgis.com/home/item.html?id=f343f6b2bbcf434386f6dde1e468e7ab.

DannyKrouk_ps

I'm sorry about the problem. I suffer the same problem myself. I'll contact the owner of the ArcGIS Monitor account and ask them to look into it. - Danny

DannyKrouk_ps

I believe the download link issues have been resolved.

SGTomlins

@DannyKrouk - I keep finding more fun tools that you guys put out there. Makes it possible to have all the answers I need to better manage the Enterprise. I love this stuff. 🙂

I reviewed the output expert xlsw file. I discovered the reporting of my backups with a warning of "No recent backups" (db_Backups). I reviewed my SQL Server logs and find the backups are working as expected and as recent as last night.

The report of the (inst_ErrorsInCurrentLog) does show successful recent backup information.

Just an FYI to consider. Not a biggie to me. I was nudged to review my settings and tasks. Always good to periodically check stuff..

All the best,

-Steve

DannyKrouk_ps

@SGTomlins Thanks for the kind words and the feedback.

This is the query that supports the backup findings:

declare @min_backups int = 1

declare @max_minutes_since_backup int = 10080 -- one week

declare @backups int

select @backups = count(*) from msdb.dbo.backupset s where s.database_name = DB_NAME()

if (@backups < @min_backups )

select cast(@backups as nvarchar(8)) as backups, 'Critical: Fewer than ' + cast(@min_backups as nvarchar(8)) + ' backups exist' as comment

else

SELECT top 10

DATEDIFF(mi, s.backup_start_date, getdate()) minutes_since_backup,

s.database_name,

m.physical_device_name,

CAST(CAST(s.backup_size / 1000000 AS INT) AS VARCHAR(14)) + ' ' + 'MB' AS bkSize,

CAST(DATEDIFF(second, s.backup_start_date,

s.backup_finish_date) AS VARCHAR(4)) + ' ' + 'Seconds' TimeTaken,

s.backup_start_date,

CASE s.[type]

WHEN 'D' THEN 'Full'

WHEN 'I' THEN 'Differential'

WHEN 'L' THEN 'Transaction Log'

END AS BackupType,

s.server_name,

s.recovery_model,

'Warning: No recent backups. Review back-up procedures relative to requirements. Age (in days): ' + cast( (DATEDIFF(mi, s.backup_start_date, getdate()) / 1440) as nvarchar(8)) as comment

FROM msdb.dbo.backupset s

INNER JOIN msdb.dbo.backupmediafamily m ON s.media_set_id = m.media_set_id

WHERE

s.database_name = DB_NAME()

and

DATEDIFF(mi, s.backup_start_date, getdate()) > @max_minutes_since_backup

ORDER BY DATEDIFF(mi, s.backup_start_date, getdate()) ASC

It strikes me that there are a few possibilities that explain your outcome:

1. There is filter logic in my query which has a different idea than you about what "recent" is.
2. There is a flaw in the query logic relative to how (some more recent version of?) SQL Server records its back-up activity.
3. There is some kind of SQL Server back-up happening that would not normally be recorded in the system tables queried ... for some reason (really a variant of #2)

As you may be able to tell from the query text, what we are examining are tables like msdb.dbo.backupset and msdb.dbo.backupmediafamily. Do the back-ups that you see in your error log also appear in these tables?

SGTomlins

@DannyKrouk : I find in both tables the most current backup sets (today) listed.

[name]

FROM [msdb].[dbo].[backupset]

and

[physical_device_name]

FROM

[msdb].[dbo].[backupmediafamily]

______________________________

Yes, I do see the backups listed in the SQL tables. Accompanied by files in their corresponding locations.

The message on the db_Backup tab is the "Warning" in your provided SQL for this backup set

This [name] and [physical device name] both show up in their respective tables. The backups are scheduled SQL Maintenance plans.

This is our SQL Server ver.

Thanks for your response. Hope this helps if there is some logic that needs tinkering or otherwise...

-Steve

DannyKrouk_ps

@SGTomlins If you would, please run the SQL statement against your system in SSMS and show me a screen capture of the result in an email (dkrouk@esri.com). Thank you. 🙂

SGTomlins

Here ya go @DannyKrouk ... Ran it this morning.

-Steve

DannyKrouk_ps

@SGTomlins Thanks. The query is seeing your backups. That's good.

From appearances, the default definition of "recent" for the egdbhealth query is out of alignment with your default definition of recent. It sees your back-ups. They are all from a week or more ago. If you run this tool right after you run take your backup, the results should be different.

Do you see another interpretation of this data?

SGTomlins

@DannyKrouk I am not certain about what you mean by my "default definition of recent". I ran the egdb the morning after the normal scheduled backups. It returned the day 7/16/24 for the top of the DESC ORDER BY, when I ran your snippet of SQL it reported 7/17/24.

I ran this today:

SELECT
bs.database_name,
bs.backup_start_date,
bs.backup_finish_date,
bs.

expiration_date,
CASE bs.type
WHEN 'D' THEN 'Database'
WHEN 'L' THEN 'Log'
WHEN 'I' THEN 'Differential'
WHEN 'F' THEN 'File or Filegroup'
WHEN 'G' THEN 'Differential File'
WHEN 'P' THEN 'Partial'
WHEN 'Q' THEN 'Differential Partial'
ELSE 'Unknown'
END AS backup_type,
bmf.physical_device_name
FROM
msdb.dbo.backupset bs
INNER JOIN
msdb.dbo.backupmediafamily bmf
ON bs.media_set_id = bmf.media_set_id
WHERE
bs.backup_start_date > DATEADD(day, -30, GETDATE()) -- Last 30 days
ORDER BY
bs.backup_start_date DESC;

It returns this:

Most recent as of 7/24/24.

Maybe I am looking at this incorrectly. Is the "gap" in dates that is reported actually showing backups that are "out of date" and toss your "Warning"?

-Steve

DannyKrouk_ps

@SGTomlins Could we please continue this conversation by email at dkrouk@esri.com? I think you and I would benefit from an opportunity to coordinate our thinking and communication in details that I do not think are relevant to this forum. Perhaps we need to graduate to a screen share to truly understand what is going on, I don't know. But, this forum-post method, from my perspective, has no more gas in the tank for our purposes.

SGTomlins

@DannyKrouk I will send you an email.. 🙂

AndresCastillo

related information:

https://community.esri.com/t5/implementing-arcgis-blog/using-egdbhealth-to-evaluate-a-geodatabase/ba-p/886488

https://mediaspace.esri.com/media/t/1_jrlj9mdw

DannyKrouk_ps

Thanks to @SGTomlins for working with me outside of this thread. We successfully found the flaw in my query logic and resolved it. The repaired query is in the online repo that egdbhealth checks on start-up. So, the new query will be downloaded and run on everyone's systems the next time they run egdbhealth. 🙂

JulianoSantosFinck

Thank you, @DannyKrouk!

Here are the full Krouk's Series:
(1) What is Egdbhealth?,
(2) Using Egdbhealth to Evaluate a Geodatabase,
(3) Using Egdbhealth in System Design

GregKlafki1

for PostgreSQL database the pre-requisites state:

If you are connecting to Oracle or PostgreSQL, you must have enabled the ST_Geometry type library

However, we are using AWS RDS PostgreSQL and cannot install ST_Geometry type library

From Geodatabases in PostgreSQL used with ArcGIS on AWS—ArcGIS Enterprise in the cloud | Documentation for ArcGIS Enterprise

Geodatabases created in Amazon Relational Database Service (RDS) for PostgreSQL store spatial data using the PostGIS geometry storage type.

Does this mean Egdbhealth will not work against AWS RDS PostgreSQL databases?

DannyKrouk_ps

Very good question. It would definitely not work for Oracle without ST_Geometry. With PostgreSQL, it might work (some queries would error). The UI would not allow it. But, you could try the command-line.

GregKlafki1

@DannyKrouk

Was able to run it via the UI, got some errors, not as many as I expected.

aurora-postgresql 15.6

The geodatabase is a read only copy that gets refreshed nightly

Just ran it without enabling the additional modules and got the expected errors. As well as not running as superuser - will get those changes made and see if it comes back error free.

On excel expert 19 errors on 108 queries and most are due to conifg for the tool

9 permission - login is not superuser
4 related to modules not loaded
3 for relation: sde_geometry_columns does not exist
2 for versioning - sde_log_compress does not exist

DannyKrouk_ps

@GregKlafki1 Nice work!

Not having an sde_log_compress simply means that there has never been a compress operation run. It could be that you don't need one. The other data in the output would help you determine that.

The modules provide helpful information. I don't know if RDS is compatible with them. But, if so, they are recommended.

The sde_geometry_columns does not exist could be a release-specific issue. I wouldn't be able to know without having access to all of the outputs. Feel free to share them with me (dkrouk@esri.com) if you would like my commentary.

AngusvonPrott

@DannyKrouk First off, thank you so much for this tool; it definitely saves us a lot of time. I have a question about the currency. Has there been a release since August 2020? I see in the ReadMe that this is the last release. I do also see that there is an updated queries function when connected to the internet. Does the tool update its version in a similar way?

Cheers,

Angus

DannyKrouk_ps

@AngusvonPrott Thanks for the question. It is true that the executable itself has not been updated recently. However, the queries have been updated many times since then. When the tool runs, it downloads the latest queries. The tool does not update itself automatically from the Internet, only the queries.

AH2

Will this tool be updated to work with Oracle RDS at AWS? We can't use as we can't add the ST Geometry library to an RDS

DannyKrouk_ps

There are no plans to update this tool for Oracle RDS on AWS. The ST_Geometry library dependencies relate not to the ST_Geometry type itself but to the fact that the library contains functions necessary to carry-out some of the queries. That said, you should be able to run the tool and let the queries with the dependency fail.

The queries themselves are all in clear text in the executable's directory structure, having file names that clearly express their purposes and how they map to the output results. So, you have all the SQL statements necessary/possible to do the equivalent of egdbhealth as much as Oracle RDS on AWS will accommodate.

Únete a la Conversación

Los miembros registrados pueden publicar, seguir actualizaciones y más. ¿Nuevo aquí? Regístrate gratis.

Enlaces Rápidos

Community Help
Find useful guides, FAQs, and documents to help you navigate and make the most of Esri Community.