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; } } }

Was ist Egdbhealth?

DannyKrouk_ps

Hinweis: Dieser Blogbeitrag ist der erste in einer Reihe von drei geplanten Beiträgen über egdbhealth. Der zweite Beitrag der Reihe wird darauf eingehen, wie man das Tool verwendet, um die Gesundheit einer Enterprise Geodatabase zu bewerten. Der dritte Beitrag der Reihe wird die Verwendung von egdbhealth im Kontext eines Systemdesigns behandeln.

Einführung

Egdbhealth ist ein Tool zur Berichterstattung über verschiedene Merkmale von Enterprise Geodatabases (eGDBes). Es liefert beschreibende Informationen über den Inhalt der eGDB und evaluative Informationen über die eGDB. Die evaluativen Informationen sind der Hauptzweck des Tools; um bestehende oder latente Probleme/Herausforderungen mit der eGDB aufzudecken. Das Tool arbeitet mit eGDBes, die von Oracle, PostgreSQL und SQL Server unterstützt werden.

Installation und Ausführung

Obwohl es keine Erweiterung für ArcGIS Monitor ist, steht egdbhealth zum Download in der ArcGIS Monitor Gallery zur Verfügung: https://arcgismonitor.maps.arcgis.com/home/item.html?id=f343f6b2bbcf434386f6dde1e468e7ab.

Installation und Voraussetzungen

Zum Installieren laden Sie einfach das .zip-Archiv herunter und entpacken die Dateien in ein Verzeichnis Ihrer Wahl.

Es gibt einige Voraussetzungen für die Ausführung von egdbhealth. Diese Überlegungen werden in der Dokumentation im .zip-Archiv (egdbhealth_README.docx) erläutert. Auf hoher Ebene sind die Voraussetzungen:

Sie benötigen einen Datenbankclient für den Typ der Datenbank (Oracle, PostgreSQL oder SQL Server), mit der Sie sich verbinden (http://desktop.arcgis.com/en/arcmap/latest/manage-data/databases/database-clients.htm).
Wenn Sie "Operating System Authentication" mit SQL Server verwenden und Ihre eGDB im Besitz von "dbo" (statt "sde") ist, müssen Sie egdbhealth als Windows-Benutzer ausführen, der dbo ist. Mit anderen Worten, Sie müssen sich als "Geodatabase Administrator" verbinden (http://desktop.arcgis.com/en/arcmap/latest/manage-data/gdbs-in-sql-server/geodatabase-administrator-sqlserver.htm). Sie müssen sich als Geodatabase Administrator mit Oracle oder PostgreSQL verbinden, aber das bedeutet normalerweise, sich als Benutzer namens "sde" zu verbinden.
Wenn Sie sich mit Oracle oder PostgreSQL verbinden, müssen Sie die ST_Geometry-Typbibliothek aktiviert haben (http://desktop.arcgis.com/en/arcmap/latest/manage-data/databases/add-the-st-geometry-type-to-an-oracle-database.htm oder http://desktop.arcgis.com/en/arcmap/latest/manage-data/databases/add-the-st-geometry-type-to-a-postgresql-database.htm).

Ausführung

Ein Doppelklick auf egdbhealth.exe öffnet ein Befehlsfenster und ein Windows-Formular.

Befolgen Sie die Anweisungen im Formular, um die Verbindungsinformationen für Ihre Datenbank auszufüllen. Tooltips geben Hinweise zur Art der benötigten Informationen. Im Prinzip sind die Informationen dieselben, die Sie ArcGIS zur Verbindung mit der Datenbank als "Geodatabase Administrator" bereitstellen würden.

Graphical User Interface

Die Schaltfläche „Test“ versucht zu bestätigen, dass Sie mit den erforderlichen Berechtigungen eine Verbindung zur eGDB herstellen können. Wenn der Test erfolgreich ist, wird die Schaltfläche „Test“ zu einer Schaltfläche „Ausführen“. Ein Klick darauf schließt das Formular und startet die Ausführung des Tools im Befehlsfenster.

Nach Abschluss des Tools wird das Unterverzeichnis „output“ geöffnet, das fünf Ausgabedateien enthält:

Eine HTML-Datei mit Metadaten über die abgefragte eGDB und das RDBMS-Ziel sowie darüber, wie die Verbindung hergestellt wird.
Eine „Context“-Excel-Datei mit beschreibenden Informationen über die eGDB und das RDBMS-Ziel.
Eine „Expert“-Excel-Datei mit evaluativen Informationen, klassifiziert als „Critical“, „Warning“ und „Information“.
Eine PNG-Datei, die den Versionsbaum darstellt.
Eine PNG-Datei, die den Statusbaum darstellt.

Vorstellung der Ausgabe

Ein Beispiel für die Ausgabedateien ist unten dargestellt:

Output files

Die Dateien tragen den „GDB Friendly Name“, den Sie im Formular angegeben haben (in diesem Beispiel „SQL_GIS“).

Die Expert Excel-Datei

Die Expert Excel-Datei ist das wichtigste Informationsartefakt. Sie liefert evaluative Informationen über das Ziel-eGDB-System. Zum Beispiel gibt es eine Bewertung, wenn die eGDB kürzlich nicht komprimiert wurde, die dies als Problem meldet.

Die Datei enthält ein Übersichtsblatt, das einen Überblick über die Bewertungen bietet. Die Bewertungen sind nach allgemeinem Thema (erste Spalte „Category“) kategorisiert und klassifiziert (Critical, Warning und Informational Spalten), sodass Sie Ihre Überprüfung der Informationen priorisieren können.

Die Spalte Beschreibung erklärt kurz den Zweck der Bewertung. Wo sich ein rotes Symbol in der Beschreibungszelle befindet, gibt es einen Hover-Tipp mit weiteren Informationen darüber, was bewertet wird.

Expert Excel file Overview sheet

Einige Befunde enthalten keine Datensätze zum Melden. Zum Beispiel gibt es keine Datensätze, wenn es kein Problem mit einer bestimmten Art von Geodatabase-Konsistenz gibt. Viele Befunde enthalten jedoch eine Anzahl von Datensätzen verschiedener Klassifikationen. In diesen Fällen enthält der Name (zweite Spalte) einen Hyperlink zum Blatt in der Arbeitsmappe mit den detaillierten Befunddatensätzen.

Die Context Excel-Datei

Die Context Excel-Datei ist ähnlich aufgebaut, enthält jedoch nicht die Expertenklassifikationsspalten (Critical-Warning-Informational). Die Informationen sind eher beschreibend und weniger evaluativ. Zum Beispiel finden Sie in dieser Datei eine Auflistung aller Geodatabase-Domains und der ObjectClasses, zu denen sie gehören. Diese Information ist weder gut noch schlecht (d.h. nicht evaluativ), kann aber nützlich sein zu wissen.

Context Excel file Overview sheet

Datensätze, die grün hervorgehoben sind, enthalten SQL-Anweisungen, die Sie bei Bedarf für weitere Informationen ausführen können. Üblicherweise sind diese SQL-Anweisungen zu aufwendig, um sie auf alle Inhalte in der eGDB auszuführen. Aber jemand, der mit der eGDB und den damit verbundenen Problemen vertraut ist, könnte dennoch Ideen haben, welche Abfragen nützlich sein könnten. Zum Beispiel enthält das Blatt „SqlGeomTypeSizeSql“ eine SQL-Abfrage für jede FeatureClass in der eGDB. Wenn Sie eine dieser Abfragen ausführen, werden die Größen der Geometrien in einer FeatureClass gemeldet. Dies ist ein so aufwändiger Vorgang, dass es nicht angemessen wäre, ihn standardmäßig für alle FeatureClasses auszuführen. Wenn jedoch eine FeatureClass ein Leistungsproblem aufweist, kann es nützlich sein, die Abfrage für diese FeatureClass auszuführen, um die Größen ihrer Geometrien zu untersuchen.<\/P>

<\/P>

Die PNGes<\/H3>Die PNG-Dateien (ein Versionsbaumdiagramm und ein Statusbaumdiagramm) sind typischerweise von Interesse, wenn Ihre eGDB Daten enthält, die als versioniert registriert wurden.<\/P> <\/P>Das Versionsbaumdiagramm veranschaulicht die Hierarchie des Versionsbaums. Die Farbkennzeichnung (rot-gelb-grün) zeigt den relativen Grad der „Veralterung“ an, also wie lange es her ist, dass die Version bearbeitet oder abgeglichen wurde.<\/P> <\/P><\/P> <\/P>Das Statusbaumschema zeigt die Tiefe und Struktur des Statusbaums (die detaillierte Struktur, auf der der Versionsbaum basiert). Die Standardversion wird in Rot angezeigt und „Status Null“ in Grün. Je weiter diese Knoten voneinander entfernt sind, desto aufwändiger ist es für die Datenbank, Informationen über die Standardversion zurückzugeben (die am häufigsten verwendete Version in den meisten Systemen).<\/P> <\/P><\/P> <\/P>Das HTML<\/H3>Das HTML liefert einige allgemeine Informationen über die eGDB, das RDBMS und die Maschine, die Ziel der Bewertung sind. Es ist in vielen Fällen möglicherweise nur von vorübergehendem Interesse.<\/P> <\/P><\/P> <\/P>Zusammenfassung<\/H2>Dieser Artikel hat den Zweck von egdbhealth beschrieben, wie man es ausführt und was seine Ausgaben sind. Da die Ausgaben des Tools eine Menge technischer Informationen enthalten, werden andere Artikel darauf eingehen, wie man die Ausgaben verwendet für (a) das Verständnis und die Verbesserung der eGDB-Gesundheit (b) das Design von GIS-Systemen.<\/SPAN><\/P> <\/P>Ich hoffe, Sie finden dies hilfreich. Zögern Sie nicht, Ihre Fragen hier zu stellen: https:\/\/community.esri.com\/thread\/231451-arcgis-architecture-series-tools-of-an-architect<\/SPAN><\/A><\/SPAN><\/P> <\/SPAN><\/P>Hinweis:<\/EM><\/STRONG> Die oben dargestellten Inhalte sind Empfehlungen, die typischerweise die Leistung in vielen Szenarien verbessern. In einigen Fällen können diese Empfehlungen jedoch keine besseren Leistungsergebnisse liefern. In diesem Fall sind zusätzliche Leistungstests und Systemkonfigurationsänderungen erforderlich.<\/EM><\/SPAN><\/P>

Finde mehr Beiträge mit dem Tag

Kommentare

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.

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

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

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

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

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

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

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?

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

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

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

SGTomlins

@DannyKrouk I will send you an email.. 🙂

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

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

-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

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

I believe the download link issues have been resolved.

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

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

The link is fixed now. 🙂

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

Anonymous User

@DannyKrouk The download link no longer works.

Nehmen Sie an der Diskussion teil

Angemeldete Mitglieder können Beiträge verfassen, Updates folgen und mehr. Neu hier? Registrieren Sie ein kostenloses Konto.

Schnellzugriffe

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