Einführung in die SQL-API¶
Die Snowflake-SQL-API ist eine REST-API , mit der Sie auf Daten in einer Snowflake-Datenbank zugreifen und diese aktualisieren können. Sie können diese API verwenden, um eigene Anwendungen und Integrationen für folgende Aufgaben zu entwickeln:
Ausführen von Abfragen
Verwalten Ihrer Implementierung (z. B. Bereitstellung von Benutzern und Rollen, Erstellen von Tabellen usw.).
Unter diesem Thema:
Fähigkeiten und Möglichkeiten der SQL-API¶
Die Snowflake-SQL-API bietet Operationen, die Sie für Folgendes verwenden können:
Übermitteln von SQL-Anweisungen zur Ausführung
Überprüfen des Ausführungsstatus von Anweisungen
Abbrechen der Ausführung von Anweisungen
Gleichzeitiges Abrufen von Abfrageergebnissen
Sie können diese API verwenden, um Standardabfragen und die meisten DDL- und DML-Anweisungen auszuführen. Weitere Informationen zu Typen von Anweisungen, die nicht unterstützt werden, finden Sie unter Einschränkungen der SQL-API.
Bei Abfragen gibt die SQL-API die Daten in Partitionen zurück. Snowflake bestimmt die Anzahl der zurückgegebenen Partitionen und die Größe der einzelnen Partitionen.
Der Endpunkt der SQL-API (/api/v2/statements) ist durch die Netzwerkrichtlinien geschützt, die den Zugriff auf Konten mit aktivierter API einschränken.
Bemerkung
Der Parameter AUTOCOMMIT muss auf Abfrage- oder Anweisungsebene auf TRUE gesetzt werden, unabhängig von dem auf Benutzer- oder Kontoebene eingestellten Wert.
Einschränkungen der SQL-API¶
Die SQL-API weist folgende Einschränkungen auf:
Die folgenden Befehle werden nicht unterstützt:
Die folgenden Befehle und Anweisungen werden nur innerhalb einer Anforderung unterstützt, die mehrere Anweisungen angibt:
Befehle, die explizite Transaktionen ausführen, einschließlich:
Befehle, die den Kontext der Sitzung ändern, einschließlich:
Anweisungen, die Sitzungsvariablen festlegen
Anweisungen, die temporäre Tabellen und Stagingbereiche erstellen (Tabellen und Stagingbereiche, die nur in der aktuellen Sitzung verfügbar sind)
Die SQL-API unterstützt derzeit keine gespeicherten Prozeduren in Python.
Hinweise zur Abrechnung bei Verwendung der SQL-API¶
Beim Abrufen bestimmter Abfrageergebnisse nutzt die SQL-API die Clouddienstschicht. Weitere Informationen zu Clouddiensten finden Sie unter Credit-Nutzung für Clouddienste.