Installieren von ST_Raster in SQL Server—Hilfe

Mit der Standard- oder Advanced-Lizenz verfügbar.

Konfigurieren der SQL Server-Instanz
Installieren von ST_Raster
Prüfen der Installation
Ändern der Geodatabase-Konfiguration

ST_Raster ist ein Datentyp, der die direkte Speicherung von Raster-Daten in einer Geodatabase-Tabelle ermöglicht. Verwenden Sie den ST_Raster-Typ, wenn Sie mit SQL auf Ihre Geodatabase-Raster-Daten zugreifen müssen.

Befolgen Sie dazu die folgenden Anweisungen:

Konfigurieren Sie die SQL Server-Instanz.
Installieren Sie ST_Raster, und überprüfen Sie, ob der Typ in der Datenbank vorhanden ist.
Ändern Sie die Geodatabase-Konfiguration, damit Benutzer ST_Raster-Daten erstellen können.

Konfigurieren der SQL Server-Instanz

Melden Sie sich am SQL Server-Remote-Hostcomputer an.
Erstellen Sie einen Ordner auf dem SQL Server-Computer, der die ST_Raster-Bibliothek enthalten soll.
Stellen Sie sicher, dass SQL Server Zugriff auf den Ordner hat.
Fügen Sie dem Systempfad den absoluten Pfad des Ordners hinzu.

Für die nächsten beiden Schritte benötigen Sie die Dateien libst_raster_sql.dll und createAssembly.sql. Sie können sie von My Esri herunterladen oder aus dem Verzeichnis <ArcGIS Server or ArcMap installation directory>\DatabaseSupport\SQLServer kopieren.

Fügen Sie die Dateien libst_raster_sql.dll und createAssembly.sql in den SQL Server-Ordner ein, den Sie in Schritt 2 erstellt haben.
Navigieren Sie von einer MS-DOS-Eingabeaufforderung auf dem SQL Server-Computer zum Speicherort der Datei createAssembly.sql, die Sie im vorherigen Schritt kopiert haben, und führen Sie "sqlcmd" aus, um sie auszuführen.
Die Assembly muss von einem "sysadmin"-Benutzer erstellt werden.
Die Syntax zum Ausführen des Skripts lautet wie folgt:
```
sqlcmd -E -S <SQL Server instance> -d  <database name> 
-v st_raster_path="<full path to folder created in step 3>\libst_raster_sql.dll" 
-v  admindb=<database name> -i createAssembly.sql
```
Beispiel:
```
sqlcmd -E -S instance1 -d  ssgdb 
-v st_raster_path="c:\mygdblibraries\libst_raster_sql.dll" 
-v  admindb=ssgdb -i createAssembly.sql
```
Weitere Informationen zum Dienstprogramm "sqlcmd" und zu dessen Verwendung finden Sie in der Dokumentation zu Microsoft SQL Server.

Nachdem die SQL Server-Instanz konfiguriert wurde, fahren Sie mit der Installation von ST_Raster und der Änderung der Geodatabase-Konfiguration fort.

Installieren von ST_Raster

Sie können das Werkzeug Raster-Typ erstellen von ArcGIS Desktop (Standard oder Advanced) oder ein Python-Skript von einem ArcGIS Server-, ArcGIS Desktop (Standard oder Advanced)- oder ArcGIS Engine-Client ausführen, um den ST_Raster-Typ zu installieren.

Ausführen des Werkzeugs Raster-Typ erstellen

Wenn Sie Zugriff auf ArcGIS Desktop (Standard oder Advanced) haben, können Sie das Werkzeug Raster-Typ erstellen ausführen, um den ST_Raster-Typ zu installieren.

Starten Sie den ArcGIS Desktop-Client.
Stellen Sie eine Verbindung mit der Geodatabase als Geodatabase-Administrator her.
Öffnen Sie das Werkzeug Raster-Typ erstellen.
Dieses Werkzeug befindet sich im Toolset "Geodatabase-Verwaltung" der Toolbox "Data Management".
Legen Sie die in Schritt 2 erstellte Datenbankverbindung als Eingabe-Datenbankverbindung fest.
Klicken Sie auf OK (ArcMap) oder auf Ausführen (ArcGIS Pro).

Verwenden von Python

Sie können ein Python-Skript ausführen, um eine Datenbankverbindungsdatei (.sde) zu erstellen, die eine Verbindung mit der Geodatabase als Geodatabase-Administrator herstellt, und den ST_Raster-Typ in der Geodatabase zu installieren.

Öffnen Sie ein Befehlsfenster, importieren Sie das ArcPy-Modul, und verwenden Sie die Funktion CreateDatabaseConnection_management, um eine Datenbankverbindungsdatei (.sde) zu erstellen, die eine Verbindung zu der Geodatabase als Geodatabase-Administrator herstellt. Wenn Sie eine Verbindung mit der Datenbankauthentifizierung herstellen, müssen Sie den Benutzernamen und das Kennwort mit der Verbindungsdatei speichern.
In diesem Beispiel wird eine Verbindungsdatei (adminconnect.sde) unter C:\temp erstellt. Die Verbindung wird mit der Projekt-Geodatabase in der teamdata-SQL Server-Instanz als SDE-Benutzer hergestellt.
```
import arcpy
arcpy.CreateDatabaseConnection_management (r'c:/temp',"adminconnect.sde", "SQL_SERVER", "teamdata", "DATABASE_AUTH", "sde", "Cky00r", "SAVE_USERNAME", "projects")
```
Installieren Sie den ST_Raster-Typ.
Hier wird die Datei adminconnect.sde von der Funktion CreateRasterType_management zum Herstellen einer Verbindung mit der Geodatabase und zum Installieren des ST_Raster-Typs verwendet:
```
arcpy.CreateRasterType_management (r'c:/temp/adminconnect.sde')
```

Prüfen der Installation

Stellen Sie mithilfe von SQL Server Management Studio eine Verbindung als beliebiger Benutzer her, der Zugriff auf die Datenbank hat, in der Sie "ST_Raster" installiert haben, und testen Sie die Installation des "ST_Raster"-Typs, indem Sie die folgende SELECT-Anweisung für diese Datenbank ausführen:

SELECT <dbo or sde>.st_raster_util_getVersion();

Die Abfrage sollte mindestens einen Wert von 1.000 zurückgeben.

Nachdem Sie die Installation von ST_Raster geprüft haben, ändern Sie die Einstellungen des Konfigurationsschlüsselworts.

Ändern der Geodatabase-Konfiguration

Nachdem ST_Raster in der Geodatabase installiert wurde, müssen Sie die Geodatabase-Konfiguration ändern, um ST_Raster anderen Benutzern beim Erstellen von Raster-Datasets und Raster-Katalogen zur Verfügung zu stellen. Dazu können Sie eine Verbindung von ArcGIS Desktop (Standard oder Advanced) herstellen und Geoverarbeitungswerkzeuge ausführen, oder Sie können ein Python-Skript verwenden, das von einem ArcGIS Server- oder ArcGIS Desktop (Standard oder Advanced)-Client ausgeführt wird.

Ausführen von Geoverarbeitungswerkzeugen

Wenn Sie Zugriff auf ArcGIS Desktop haben, können Sie das Werkzeug Konfigurationsschlüsselwörter für Geodatabase exportieren verwenden, um die aktuellen Konfigurationseinstellungen der Geodatabase in eine Textdatei zu exportieren, den Parameter RASTER_STORAGE in der Textdatei auf "ST_Raster" festzulegen und die geänderte Textdatei mit dem Werkzeug Geodatabase-Konfigurationsschlüsselwort importieren zu importieren.

Öffnen Sie das Werkzeug Konfigurationsschlüsselwörter für Geodatabase exportieren in ArcGIS Desktop.
Verwenden Sie die Datenbankverbindung, die Sie zum Installieren von ST_Raster als Eingabe-Datenbankverbindung festgelegt haben.
Legen Sie einen Speicherort und einen Dateinamen für die Textdatei fest, die erstellt werden soll.
Öffnen Sie die Textdatei in einem Texteditor, und legen Sie RASTER_STORAGE auf "ST_Raster" fest.
- Wenn alle Raster-Datasets und Raster-Kataloge den ST_Raster-Typ verwenden sollen, ohne dass die Benutzer ein Schlüsselwort angeben müssen, ändern Sie den Parameter RASTER_STORAGE unter dem Schlüsselwort DEFAULTS.
- Wenn der ST_Raster-Typ nur von einigen Raster-Datasets und Raster-Katalogen verwendet werden soll, erstellen Sie ein benutzerdefiniertes Schlüsselwort, und legen Sie den Parameter RASTER_STORAGE für dieses Schlüsselwort auf "ST_Raster" fest.
Speichern und schließen Sie die Textdatei.
Importieren Sie die geänderte Textdatei mit dem Werkzeug Konfigurationsschlüsselwörter für Geodatabase importieren in die Geodatabase.

Verwenden von Python

Sie verwenden die ArcPy-Funktion ExportGeodatabsaeConfigurationKeyword_management, um die aktuellen Geodatabase-Konfigurationseinstellungen in eine Textdatei zu exportieren sowie die Textdatei zu bearbeiten und zu speichern. Anschließend verwenden Sie die Funktion ImportGeodatabaseConfigurationKeyword_management, um Änderungen in die Geodatabase zu importieren.

Verwenden Sie die Datenbankverbindungsdatei, die Sie beim Installieren von "ST_Raster" für die input_database erstellt haben, wenn Sie die beiden Funktionen ExportGeodatabsaeConfigurationKeyword_management und ImportGeodatabaseConfigurationKeyword_management ausführen.

Exportieren Sie die aktuelle Geodatabase-Konfiguration.
In diesem Beispiel wird die Datei gdbconfig in den Ordner C:\temp exportiert.
```
arcpy.ExportGeodatabaseConfigurationKeyword_management (r'c:/temp/adminconnect.sde', r'c:/temp/gdbconfig.txt')
```
Öffnen Sie die Textdatei in einem Texteditor, und legen Sie RASTER_STORAGE auf "ST_Raster" fest.
- Wenn alle Raster-Datasets und Raster-Kataloge den ST_Raster-Typ verwenden sollen, ohne dass die Benutzer ein Schlüsselwort angeben müssen, ändern Sie den Parameter RASTER_STORAGE unter dem Schlüsselwort DEFAULTS.
- Wenn der ST_Raster-Typ nur von einigen Raster-Datasets und Raster-Katalogen verwendet werden soll, erstellen Sie ein benutzerdefiniertes Schlüsselwort, und legen Sie den Parameter RASTER_STORAGE für dieses Schlüsselwort auf "ST_Raster" fest.
Speichern und schließen Sie die Textdatei.

Importieren Sie die geänderte Datei.

arcpy.ImportGeodatabaseConfigurationKeyword_management (r'c:/temp/adminconnect.sde', r'c:/temp/gdbconfig.txt')

Ihre neuen Konfigurationseinstellungen sind nun verfügbar, wenn die Daten erstellt werden.