Legt einen Nachrichtensteuerungsparameter für eine SQL Remote-Nachrichtenverbindung fest.
SET REMOTE link-name OPTION [ userid.| PUBLIC.]link-option-name = link-option-value
link-name : file | ftp | http | smtp
link-option-name : common-options | file-options | ftp-options | smtp-options
common-options : debug | encode_dll | max_retries | output_log_send_on_error | output_log_send_limit | output_log_send_now | pause_after_failure
file-options : directory | invalid_extensions | unlink_delay
ftp-options : active_mode | host | invalid_extensions | password | port | root_directory | reconnect_retries | reconnect_pause | suppress_dialogs | user
http-options : | certificate | client_port | https | password | proxy | reconnect_retries | reconnect_pause | root_directory | url | user
smtp-options : local_host | pop3_host | pop3_password | pop3_port | pop3_userid | smtp_authenticate | smtp_option | smtp_password | smtp_port | smtp_userid | suppress_dialogs | top_supported
link-option-value : string
userid Wenn Sie keine userid eingeben, wird der aktuelle Publikationseigentümer genommen.
common-options Folgende Optionen gelten für die FILE-, FTP-, HTTP- und SMTP-Nachrichtensysteme gleichermaßen:
debug Dieser Parameter ist entweder auf YES oder NO gesetzt. Der Standardwert ist NO. Wenn auf YES gesetzt, werden spezifische Debug-Ausgaben des Nachrichtensystems angezeigt. Diese Informationen können verwendet werden, um Probleme im Nachrichtensystem zu beheben.
max_retries Standardmäßig gilt: Wenn SQL Remote im kontinuierlichen Modus ausgeführt wird und ein Fehler tritt auf, wenn auf das Nachrichtensystem zugegriffen wird, wird es automatisch nach den Sende- und/oder Empfangsphasen heruntergefahren. Verwenden Sie diesen Parameter, um die Häufigkeit festzulegen, mit der Sie aus SQL Remote zu wiederholen Sie den Sende- und/oder von der Synchronisation, bevor sie beendet.
output_log_send_on_error Sendet Loginformationen, wenn ein Fehler auftritt.
output_log_send_limit Begrenzt die Menge der Informationen, die an die konsolidierte Datenbank gesendet werden. Die Option output_log_send_limit gibt die Anzahl von Bytes am Ende des Ausgabelogs an (d.h. die aktuellsten Einträge), die an die konsolidierte Datenbank gesendet wird. Der Standardwert ist 5 kB.
output_log_send_now Wenn auf YES gesetzt, werden Ausgabeloginformationen an die konsolidierte Datenbank gesendet. Beim nächsten Abruf sendet die entfernte Datenbank die Ausgabeloginformationen und setzt anschließend die Option output_log_send_now auf NO.
pause_after_failure Dieser Parameter gilt, wenn der max_retries-Parameter auf einen anderen Wert als Null gesetzt ist, und SQL Remote im kontinuierlichen Modus ausgeführt wird. Wenn ein Fehler im Nachrichtensystem auftritt, definiert dieser Parameter die Anzahl der Sekunden, die SQL Remote wartet, bis die Sende- und/oder Empfangsphasen wiederholt werden.
encode_dll Wenn Sie ein benutzerdefiniertes Kodierungsschema implementiert haben, müssen Sie dies auf den vollständigen Pfad der von Ihnen erstellten angepassten Kodierungs-DLL einstellen.
file-options Folgende Optionen gelten nur für das FILE-Nachrichtensystem:
directory Das Verzeichnis, in dem die Nachrichten gespeichert werden. Dieser Parameter ist eine Alternative zur SQLREMOTE-Umgebungsvariablen.
invalid_extensions Eine durch Kommas getrennte Liste von Dateierweiterungen, die vom SQL Remote-Nachrichtenagenten (dbremote) beim Generieren von Dateien im Nachrichtensystem nicht verwendet werden sollen.
unlink_delay Die Sekunden, die abgewartet werden sollen, bevor eine Datei gelöscht wird, falls der vorherige Versuch, die Datei zu löschen, fehlgeschlagen ist. Wenn für unlink_delay kein Wert definiert ist, wird als Standardverhalten 1 Sekunde nach dem ersten fehlgeschlagenen Versuch, 2 Sekunden nach dem zweiten, 3 Sekunden nach dem dritten und 4 Sekunden nach dem vierten gewartet.
ftp-options Folgende Optionen gelten nur für das FTP-Nachrichtensystem:
active_mode Dieser Parameter steuert, wie SQL Remote die Client-/Server-Verbindung herstellt. Dieser Parameter ist entweder auf YES oder NO gesetzt. Der Standardwert ist NO (passiver Modus). Der passive Modus ist der bevorzugte Übermittlungsmodus und der Standardwert für die FTP-Nachrichtenverbindung. Im passiven Modus werden alle Datenübertragungsverbindungen durch den Client initiiert, in diesem Fall durch die Nachrichtenverbindung. Im aktiven Modus initiiert der FTP-Server alle Datenverbindungen.
host Der Hostname des Computers, auf dem der FTP-Server läuft. Dieser Parameter kann ein Hostname (z.B. FTP.ianywhere.com) oder eine IP-Adresse (z.B. 192.138.151.66) sein.
invalid_extensions Eine durch Kommas getrennte Liste von Dateierweiterungen, die von dbremote beim Generieren von Dateien im Nachrichtensystem nicht verwendet werden sollen.
password Das Kennwort für den Zugriff auf den FTP-Host
port Die IP-Portnummer, die für die FTP-Verbindung verwendet wird. Dieser Parameter wird gewöhnlich nicht benötigt.
reconnect_retries Gibt an, wie häufig die Verbindung versuchen soll, einen Socket zu öffnen, bevor der Versuch abgebrochen wird. Der Standardwert ist "4". Wenn Sie diesen Parameter setzen, sind nur erneute Verbindungen betroffen. Die ursprünglich vom FTP-Link erstellte Verbindung ist nicht betroffen.
reconnect_pause Die Zeit in Sekunden, die zwischen den Verbindungsversuchen abgewartet wird. Der Standardwert ist 30 Sekunden. Wenn Sie diesen Parameter setzen, sind nur erneute Verbindungen betroffen. Die ursprünglich vom FTP-Link erstellte Verbindung ist nicht betroffen.
root_directory Das Stammverzeichnis auf der FTP-Host-Site, unter dem die Nachrichten gespeichert werden.
suppress_dialogs Dieser Parameter ist auf TRUE oder FALSE gesetzt. Wenn dieser Parameter auf TRUE gesetzt ist, wird das Fenster Verbinden nach gescheiterten Verbindungsversuchen zum FTP-Server nicht angezeigt. Stattdessen wird eine Fehlermeldung ausgegeben.
user Der Benutzername für den Zugriff auf den FTP-Host
http-options Diese Optionen gelten nur für das HTTP-Nachrichtensystem:
certificate Um eine sichere (HTTPS-)Anforderung durchführen zu können, muss der Client Zugriff auf das vom HTTPS-Server verwendete Zertifikat haben. Die benötigten Informationen werden in einer Zeichenfolge von durch Semikola getrennten Schlüssel/Werte-Paaren angegeben. Sie können mithilfe des Dateischlüssels den Dateinamen für das Zertifikat angeben. Sie können nicht sowohl einen Dateischlüssel als auch einen Zertifikatschlüssel angeben. Folgende Schlüssel sind verfügbar:
Schlüssel | Abkürzung | Beschreibung |
---|---|---|
file | The file name of the certificate | |
certificate | cert | The certificate itself |
company | co | The company specified in the certificate |
unit | The company unit specified in the certificate | |
name | The common name specified in the certificate |
Zertifikate sind nur bei Anforderungen erforderlich, die entweder an den HTTPS-Server gerichtet sind oder von einem nicht-sicheren zu einem sicheren Server umgeleitet werden können. Nur PEM-formatierte Zertifikate werden unterstützt. certificate='Datei=Dateiname'
Zertifikatnamen in SQL Anywhere-Datenbanken erstellen
CREATE OR REPLACE CERTIFICATE certificate_name FROM FILE 'certificate_file'; |
Zertifikatnamen für einen HTTPS-Nachrichtentyp verwenden
SET REMOTE HTTP OPTION user_name.certificate = 'cert_name=certificate_name'; |
client_port Kennzeichnet die Portnummer, auf der SQL Remote unter Verwendung von HTTP kommuniziert. Sie wird nur für Verbindungen über Firewalls bereitgestellt und empfohlen, die "ausgehende" TCP/IP-Verbindungen filtern. Sie können eine einzelne Portnummer, Bereiche von Portnummern oder eine Kombination aus beiden angeben. Die Angabe einer niedrigen Anzahl von Clientports kann dazu führen, dass SQL Remote nicht in der Lage ist, Nachrichten zu senden und zu empfangen, wenn das Betriebssystem die Ports nicht rechtzeitig freigibt, nachdem SQL Remote den Port bei einer früheren Ausführung geschlossen hat.
debug Wenn dieser Parameter auf YES eingestellt ist, werden alle HTTP-Befehle und -Antworten im Ausgabelog angezeigt. Diese Informationen können zur Fehlerbehandlung von HTTP-Problemen verwendet werden. Der Standardwert ist NO.
https Geben Sie an, ob HTTPS (https=yes) oder HTTP (https=no) verwendet werden soll.
password Das Kennwort für die Nachrichtenserver-Datenbank. Das Kennwort authentifiziert bei HTTP-Servern und Gateways anderer Hersteller, die RFC 2617 Basic-Authentifizierung verwenden.
proxy_host Gibt den URI eines Proxyservers an. Wird verwendet, wenn SQL Remote über einen Proxyserver auf das Netzwerk zugreifen muss. Zeigt an, dass SQL Remote eine Verbindung zum Proxyserver herstellen soll, um die Anforderung durch ihn an den Nachrichtenserver zu senden.
reconnect_retries Gibt an, wie häufig die Verbindung versuchen soll, einen Socket zu öffnen, bevor der Versuch abgebrochen wird. Der Standardwert ist "4". Wenn Sie diesen Parameter setzen, sind nur erneute Verbindungen betroffen. Die ursprünglich vom FTP-Link erstellte Verbindung ist nicht betroffen.
reconnect_pause Die Zeit in Sekunden, die zwischen den Verbindungsversuchen abgewartet wird. Der Standardwert ist 30 Sekunden. Wenn Sie diesen Parameter setzen, sind nur erneute Verbindungen betroffen. Die ursprünglich vom FTP-Link erstellte Verbindung ist nicht betroffen.
root_directory Dieser HTTP-Steuerungsparameter wird ignoriert, wenn er auf Clientseite festgelegt wurde. Sie müssen diesen Steuerungsparameter im Nachrichtenserver festlegen, bevor Sie die gespeicherte Prozedur sr_add_message_server oder sr_update_message_server aufrufen. Bei der Verwendung des HTTP-Nachrichtensystems kann die für einen entfernten Benutzer oder Publikationseigentümer angegebene Adresse nur ein einziges Unterverzeichnis enthalten und nicht mehrere Unterverzeichnisse.
url Geben Sie den Servernamen oder die IP-Adresse sowie optional die Portnummer für den verwendeten HTTP-Server an, durch Semikola getrennt. Wenn Anforderungen durch den Relay Server übergeben werden, können Sie optional eine URL-Erweiterung hinzufügen, um anzuzeigen, an welche Serverfarm die Anforderung übergeben werden soll.
user Die Benutzer-ID für die Nachrichtenserver-Datenbank. Dient zum Authentifizieren bei HTTP-Servern und Gateways anderer Hersteller, die RFC 2617 Basic-Authentifizierung verwenden.
smtp-options Folgende Optionen gelten nur für das SMTP-Nachrichtensystem:
local_host Der Name des lokalen Computers. Er ist auf Computern nützlich, bei denen SQL Remote nicht in der Lage ist, den lokalen Hostnamen zu bestimmen. Der lokale Hostname wird benötigt, um eine Sitzung mit einem SMTP-Server zu initialisieren. In den meisten Netzwerkumgebungen kann der Hostname automatisch ermittelt werden. In diesem Fall wird dieser Eintrag nicht gebraucht.
pop3_host Der Name des Computers, auf dem der POP-Host läuft. Üblicherweise ist dies derselbe Name wie der SMTP-Host:. Er entspricht dem POP3-Hostfeld im SMTP/POP3-Login-Fenster.
pop3_password Das Kennwort, das zum Abrufen der Mail verwendet wird. Der Wert entspricht dem Kennwortfeld im SMTP/POP3-Login-Fenster.
pop3_port Die Nummer des Ports, den der POP3-Server abhört. Der Standardwert ist 110. Dies entspricht dem Portfeld im SMTP/POP3-Login-Fenster.
pop3_userid Die Benutzer-ID, die zum Abrufen der Mail verwendet wird. Die POP3-Benutzer-ID entspricht dem Benutzer-ID-Feld im SMTP/POP3-Login-Fenster. Sie erhalten eine Benutzer-ID von Ihrem POP3-Host-Administrator.
smtp_host Der Name des Computers, auf dem der SMTP-Server läuft. Er entspricht dem SMTP-Hostfeld im SMTP/POP3-Login-Fenster
top_supported SQL Remote verwendet einen POP3-Befehl namens TOP, um eintreffende Nachrichten zu verarbeiten. Der TOP-Befehl wird möglicherweise nicht von allen POP3-Servern unterstützt. Wenn Sie den Parameter "top_supported" auf NO setzen, verwendet SQL Remote den RETR-Befehl, der weniger effizient ist, aber mit allen POP-Servern funktioniert. Der Standardwert ist YES.
smtp_authenticate Legt fest, ob die SMTP-Verbindung den Benutzer authentifiziert. Der Standardwert ist YES. Setzen Sie diesen Parameter auf NO, um die SMTP-Authentifizierung zu deaktivieren.
smtp_userid Die Benutzer-ID für die SMTP-Authentifizierung. Standardmäßig übernimmt dieser Parameter denselben Wert wie der Parameter pop3_userid. Der Parameter "smtp_userid" muss nur gesetzt werden, wenn die Benutzer-ID von der des POP-Servers abweicht.
smtp_password Das Kennwort für die SMTP-Authentifizierung. Standardmäßig übernimmt dieser Parameter denselben Wert wie der Parameter pop3_password. Der Parameter "smtp_password" muss nur gesetzt werden, wenn die Benutzer-ID von der des POP-Servers abweicht.
smtp_port Die Nummer des Ports, den der SMTP-Server derzeit abhört. Standardwert ist "25". Dies entspricht dem Portfeld im SMTP/POP3-Login-Fenster.
suppress_dialogs Wenn dieser Parameter auf TRUE gesetzt ist, wird das Fenster Verbinden nach gescheiterten Verbindungsversuchen zum Mail-Server nicht angezeigt. Stattdessen wird eine Fehlermeldung ausgegeben.
Der SQL Remote (dbremote)-Nachrichtenagent speichert Nachrichtenverbindungsparameter, die der Benutzer in das Fenster für den Nachrichtenagenten eingibt, wenn die Nachrichtenverbindung das erste Mal verwendet wird. In diesem Fall ist es nicht nötig, diese Anweisung explizit zu verwenden. Diese Anweisung ist besonders von Nutzen, wenn eine konsolidierte Datenbank für das Extrahieren von zahlreichen Datenbanken vorbereitet wird.
Bei den Optionsnamen wird die Groß-/Kleinschreibung berücksichtigt. Ob die Optionswerte auf Groß-/Kleinschreibung reagieren, hängt von der Option ab: Boolesche Werte reagieren nicht, während Kennwörter, Verzeichnisnamen und andere Zeichenfolgen abhängig von der Reaktion auf Groß-/Kleinschreibung des Dateisystems (bei Verzeichnisnamen) oder der Datenbank (bei Benutzer-IDs und Kennwörtern) sind.
Der Publikationseigentümer kann seine eigenen Optionen setzen. Andernfalls müssen Sie die SYS_REPLICATION_ADMIN_ROLE-Systemrolle haben.
Automatisches Festschreiben (Autocommit).
SQL/2008 Erweiterung des Herstellers.
Die folgende Anweisung legt den FTP-Host für die FTP-Verbindung des Benutzers Sam_Singer auf ftp.mycompany.com fest:
SET REMOTE FTP OPTION Sam_Singer.host = 'ftp.mycompany.com'; |
Die folgende Anweisung verhindert, dass SQL Remote die angegebenen Dateierweiterungen für Meldungen verwendet, die generiert werden:
SET REMOTE FTP OPTION "Public"."invalid_extensions"='exe,pif,dll,bat,cmd,vbs'; |
Die folgende Anweisung legt die URL so fest, dass sie auf den Localhost für die HTTP-Verbindung des Benutzers Sam_Singer zeigt:
SET REMOTE HTTP OPTION Sam_Singer.url='localhost:8033'; |
Die folgende Anweisung legt die HTTP-URL so fest, dass sie auf einen Relay Server verweist, der die Anforderung an die SRHTTP-Farm weiterleitet:
SET REMOTE HTTP OPTION "public"."url"='iis7.company.com:80/rs/client/rs_client.dll/srhttp'; |
![]() |
Kommentieren Sie diese Seite in DocCommentXchange.
|
Copyright © 2013, SAP AG oder ein SAP-Konzernunternehmen. - SAP Sybase SQL Anywhere 16.0 |