Installieren von ST_Raster-Dataset in SQL Server—Hilfe

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

Konfigurieren der SQL Server-Instanz
Installieren von ST_Raster
Bestätigen 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-Server, 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.
Kopieren Sie die Datei "libst_raster_sql.dll" aus dem Verzeichnis <ArcGIS client installation directory>\DatabaseSupport\SQLServer, und fügen Sie sie in den SQL Server-Ordner ein, den Sie in Schritt 3 erstellt haben.
Kopieren Sie die Datei "createAssembly.sql" aus dem Verzeichnis <ArcGIS client installation directory>\DatabaseSupport\SQLServer, und fügen Sie sie in den Ordner ein, den Sie in Schritt 3 erstellt haben.
Navigieren Sie von einer MS-DOS-Eingabeaufforderung 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 for Desktop (Standard oder Advanced) oder ein Python-Skript von einem ArcGIS for Server (Standard oder Advanced)-, ArcGIS for Desktop- 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 for Desktop (Standard oder Advanced) haben, können Sie das Werkzeug Raster-Typ erstellen ausführen, um den ST_Raster-Typ zu installieren.

Starten Sie ArcCatalog oder ArcMap.
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, um das Werkzeug auszuführen.

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 unter C:\temp eine Verbindungsdatei (adminconnect.sde) 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')
```

Bestätigen der Installation

Stellen Sie mithilfe von SQL Server Management Studio eine Verbindung als beliebiger Benutzer her, der Zugriff auf die Datenbank hat, auf 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 bestätigt 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 for Desktop (Standard oder Advanced) herstellen und Geoverarbeitungswerkzeuge ausführen, oder Sie können ein Python-Skript verwenden, das von einem ArcGIS for Server- oderArcGIS for Desktop (Standard oder Advanced)-Client ausgeführt wird.

Ausführen von Geoverarbeitungswerkzeugen

Wenn Sie Zugriff auf ArcGIS for Desktop haben, können Sie das Werkzeug Geodatabase-Konfigurationsschlüsselwort 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 Geodatabase-Konfigurationsschlüsselwort exportieren in ArcGIS for 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 RASTER_STORAGE-Parameter 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 RASTER_STORAGE-Parameter 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 Geodatabase-Konfigurationsschlüsselwort 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 RASTER_STORAGE-Parameter 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 RASTER_STORAGE-Parameter 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.