CloudTableClient Klasse
- java.
lang. Object - ServiceClient
- com.
microsoft. azure. storage. table. CloudTableClient
- com.
public class CloudTableClient extends ServiceClient
Stellt einen Dienstclient für den Zugriff auf den Microsoft Azure Table-Dienst bereit.
Die CloudTableClient -Klasse kapselt den Basis-URI für den Tabellendienstendpunkt und die Anmeldeinformationen für den Zugriff auf das Speicherkonto und stellt Methoden zum Erstellen, Löschen, Auflisten und Abfragen von Tabellen sowie Methoden zum Ausführen von Vorgängen und Abfragen für Tabellenentitäten bereit. Diese Methoden rufen Speicherdienst-REST-API-Vorgänge auf, um die Anforderungen auszuführen und die zurückgegebenen Ergebnisse zu erhalten.
Ein Tabellendienstendpunkt ist der Basis-URI für Tabellendienstressourcen, einschließlich des DNS-Namens des Speicherkontos:
Weitere Informationen finden Sie im MSDN-Thema Adressierung von Tabellendienstressourcen.
Die Anmeldeinformationen können eine Kombination aus dem Speicherkontonamen und einem Schlüssel oder einer Shared Access Signature sein. Weitere Informationen finden Sie im MSDN-Thema Authentifizieren des Zugriffs auf Ihr Speicherkonto.
Zusammenfassung zum Konstruktor
Konstruktor | Beschreibung |
---|---|
CloudTableClient(final StorageUri baseUri, StorageCredentials credentials) |
Initialisiert eine instance der -Klasse mithilfe eines Tabellendienstendpunkts und der Anmeldeinformationen des Speicherkontos. |
CloudTableClient(final URI baseUri, StorageCredentials credentials) |
Initialisiert einen instance der -Klasse mithilfe eines Table-Dienstendpunkts und der Anmeldeinformationen für das Speicherkonto. |
Methodenzusammenfassung
Modifizierer und Typ | Methode und Beschreibung |
---|---|
final Service |
downloadServiceProperties()
Ruft den aktuellen ServiceProperties für den angegebenen Speicherdienst ab. Dies umfasst Protokollierung, HourMetrics, MinuteMetrics und CORS-Konfigurationen. |
final Service |
downloadServiceProperties(TableRequestOptions options, OperationContext opContext)
Ruft den aktuellen ServiceProperties für den angegebenen Speicherdienst ab. Dies umfasst Protokollierung, HourMetrics, MinuteMetrics und CORS-Konfigurationen. |
<T extends Table |
executeQuerySegmentedImpl(final TableQuery<T> queryToExecute, final EntityResolver<R> resolver, final ResultContinuation continuationToken, TableRequestOptions options, OperationContext opContext)
Für die interne Verwendung reserviert. Führt einen segmentierten Abfragevorgang unter Verwendung der angegebenen Wiederholungs- und Timeoutrichtlinien aus. |
<T extends Table |
generateIteratorForQuery(final TableQuery<T> queryRef, final EntityResolver<R> resolver, TableRequestOptions options, OperationContext opContext)
Für die interne Verwendung reserviert. Generiert einen Iterator für einen segmentierten Abfragevorgang. |
Table |
getDefaultRequestOptions()
Ruft die ab, die für Anforderungen verwendet wird, die TableRequestOptions diesem zugeordnet sind. |
Service |
getServiceStats()
Fragt den Dienst nach ab ServiceStats. |
Service |
getServiceStats(TableRequestOptions options, OperationContext opContext)
Fragt den angegebenen Speicherdienst für ab ServiceStats. |
Cloud |
getTableReference(final String tableName)
Ruft ein CloudTable -Objekt mit dem angegebenen Namen ab. |
final Storage |
getTransformedEndPoint(final OperationContext opContext) |
boolean |
isUsePathStyleUris()
Gibt an, ob pfadartige URIs verwendet werden. |
Iterable<String> |
listTables()
Listet die Tabellennamen im Speicherkonto auf. Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen unter Verwendung des Tabellendienstendpunkts und der Anmeldeinformationen des Speicherkontos dieses instance aufzulisten. |
Iterable<String> |
listTables(final String prefix)
Listet die Tabellennamen im Speicherkonto auf, die dem angegebenen Präfix entsprechen. Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen aufzulisten, die dem Präfix entsprechen, wobei der Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos dieses instance verwendet werden. |
Iterable<String> |
listTables(final String prefix, final TableRequestOptions options, final OperationContext opContext)
Listet die Tabellennamen im Speicherkonto auf, die dem angegebenen Präfix entsprechen, wobei die angegebenen TableRequestOptions und verwendet OperationContextwerden. Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen aufzulisten, die dem Präfix entsprechen, wobei der Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos dieses instance verwendet werden. Verwenden Sie die TableRequestOptions , um Ausführungsoptionen wie das Timeout oder die Wiederholungsrichtlinie für den Vorgang außer Kraft zu setzen. |
Result |
listTablesSegmented()
Listet die Tabellennamen im segmentierten Modus im Speicherkonto auf. Mit dieser Methode kann die Auflistung von Tabellen fortgesetzt werden, nachdem ein Teilsatz von Ergebnissen zurückgegeben wurde, wobei die vom Server im ResultSegment<T> -Objekt zurückgegebenen Informationen verwendet werden. Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen unter Verwendung des Tabellendienstendpunkts und der Anmeldeinformationen des Speicherkontos dieses instance aufzulisten. |
Result |
listTablesSegmented(final String prefix)
Listet die Tabellennamen im Speicherkonto auf, die dem angegebenen Präfix im segmentierten Modus entsprechen. Mit dieser Methode kann die Auflistung von Tabellen fortgesetzt werden, nachdem ein Teilsatz von Ergebnissen zurückgegeben wurde, wobei die vom Server im ResultSegment<T> -Objekt zurückgegebenen Informationen verwendet werden. Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen aufzulisten, die dem Präfix entsprechen, wobei der Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos dieses instance verwendet werden. |
Result |
listTablesSegmented(final String prefix, final Integer maxResults, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext)
Listet bis zum angegebenen Maximum der Tabellennamen im Speicherkonto auf, die dem angegebenen Präfix in einem fortsetzbaren Modus mit dem angegebenen ResultContinuation Fortsetzungstoken entsprechen, wobei die angegebenen TableRequestOptions und OperationContextverwendet werden. Mit dieser Methode kann das Auflisten von Tabellen fortgesetzt werden, nachdem eine Seite mit Ergebnissen zurückgegeben wurde, wobei informationen verwendet werden, die vom Server im ResultSegment<T> -Objekt zurückgegeben werden. Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen auflisten zu können, die dem Präfix entsprechen, und verwendet dabei den Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos dieses instance. Verwenden Sie , TableRequestOptions um Ausführungsoptionen wie das Timeout oder die Wiederholungsrichtlinie für den Vorgang zu überschreiben. |
void |
setDefaultRequestOptions(TableRequestOptions defaultRequestOptions)
Legt den fest, der TableRequestOptions für jede Tabelle verwendet wird, auf die mit diesem Objekt zugegriffen wird. |
void |
uploadServiceProperties(final ServiceProperties properties)
Lädt eine neue ServiceProperties Konfiguration in den angegebenen Speicherdienst hoch. Dazu gehören Protokollierung, HourMetrics, MinuteMetrics und CORS-Konfigurationen. |
void |
uploadServiceProperties(final ServiceProperties properties, TableRequestOptions options, OperationContext opContext)
Lädt eine neue ServiceProperties Konfiguration in den angegebenen Speicherdienst hoch. Dazu gehören Protokollierung, HourMetrics, MinuteMetrics und CORS-Konfigurationen. |
Geerbte Elemente
Details zum Konstruktor
CloudTableClient
public CloudTableClient(final StorageUri baseUri, StorageCredentials credentials)
Initialisiert eine instance der -Klasse mithilfe eines Tabellendienstendpunkts und der Anmeldeinformationen des Speicherkontos.
Parameters:
CloudTableClient
public CloudTableClient(final URI baseUri, StorageCredentials credentials)
Initialisiert einen instance der -Klasse mithilfe eines Table-Dienstendpunkts und der Anmeldeinformationen für das Speicherkonto.
Parameters:
java.net.URI
-Objekt, das den Table-Dienstendpunkt darstellt, der zum Initialisieren des Clients verwendet wird.
Details zur Methode
downloadServiceProperties
public final ServiceProperties downloadServiceProperties()
Ruft den aktuellen ServiceProperties für den angegebenen Speicherdienst ab. Dies umfasst Protokollierung, HourMetrics, MinuteMetrics und CORS-Konfigurationen.
Returns:
Throws:
downloadServiceProperties
public final ServiceProperties downloadServiceProperties(TableRequestOptions options, OperationContext opContext)
Ruft den aktuellen ServiceProperties für den angegebenen Speicherdienst ab. Dies umfasst Protokollierung, HourMetrics, MinuteMetrics und CORS-Konfigurationen.
Parameters:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
Throws:
executeQuerySegmentedImpl
protected
Für die interne Verwendung reserviert. Führt einen segmentierten Abfragevorgang unter Verwendung der angegebenen Wiederholungs- und Timeoutrichtlinien aus.
Parameters:
R
erstellt. Übergeben, null
um die Ergebnisse als Tabellenentitätstyp zurückzugeben.
null
für eine erste Abfrage.
null
an, um die auf CloudTableClientdem angegebenen Anforderungsoptionen zu verwenden.
null
, um den Vorgangskontext sicher zu ignorieren.
Returns:
Throws:
generateIteratorForQuery
protected
Für die interne Verwendung reserviert. Generiert einen Iterator für einen segmentierten Abfragevorgang.
Parameters:
R
erstellt. Übergeben, null
um die Ergebnisse als Tabellenentitätstyp zurückzugeben.
null
an, um die auf CloudTableClientdem angegebenen Anforderungsoptionen zu verwenden.
null
, um den Vorgangskontext sicher zu ignorieren.
Returns:
Iterable
für den von der TableEntity Abfrage zurückgegebenen Typ oderEntityResolver<T>.getDefaultRequestOptions
public TableRequestOptions getDefaultRequestOptions()
Ruft die ab, die für Anforderungen verwendet wird, die TableRequestOptions diesem zugeordnet sind.
Returns:
CloudTableClient
getServiceStats
public ServiceStats getServiceStats()
Fragt den Dienst nach ab ServiceStats.
Returns:
ServiceStats für den angegebenen Speicherdienst
Throws:
getServiceStats
public ServiceStats getServiceStats(TableRequestOptions options, OperationContext opContext)
Fragt den angegebenen Speicherdienst für ab ServiceStats.
Parameters:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
ServiceStats für den angegebenen Speicherdienst
Throws:
getTableReference
public CloudTable getTableReference(final String tableName)
Ruft ein CloudTable -Objekt mit dem angegebenen Namen ab.
Parameters:
String
, der den Namen der Tabelle darstellt, die den Tabellenbenennungsregeln entsprechen muss. Der Tabellenname darf keine Pfadtrennzeichen (/) enthalten. Bei Tabellennamen wird die Groß-/Kleinschreibung nicht beachtet, muss innerhalb eines Kontos eindeutig sein und muss zwischen 3 und 63 Zeichen lang sein. Tabellennamen müssen mit einem nicht beginnen mit einem numerischen Zeichen beginnen und dürfen nur alphanumerische Zeichen enthalten. Einige Tabellennamen sind reserviert, einschließlich "Table".
Returns:
Throws:
getTransformedEndPoint
protected final StorageUri getTransformedEndPoint(final OperationContext opContext)
Parameters:
isUsePathStyleUris
protected boolean isUsePathStyleUris()
Gibt an, ob pfadartige URIs verwendet werden.
Returns:
true
, wenn pfadartige URIs verwendet werden; andernfalls false
.
listTables
public Iterable
Listet die Tabellennamen im Speicherkonto auf.
Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen unter Verwendung des Tabellendienstendpunkts und der Anmeldeinformationen des Speicherkontos dieses instance aufzulisten.
Returns:
Iterable
Auflistung der Tabellennamen im Speicherkonto, die lazily abgerufen wird.listTables
public Iterable
Listet die Tabellennamen im Speicherkonto auf, die dem angegebenen Präfix entsprechen.
Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen aufzulisten, die dem Präfix entsprechen, wobei der Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos dieses instance verwendet werden.
Parameters:
String
, die das Präfix enthält, das für zurückzugebende Tabellennamen übereinstimmen soll.
Returns:
Iterable
Auflistung der Tabellennamen im Speicherkonto, die lazily abgerufen werden und dem angegebenen Präfix entsprechen.listTables
public Iterable
Listet die Tabellennamen im Speicherkonto auf, die dem angegebenen Präfix entsprechen, wobei die angegebenen TableRequestOptions und verwendet OperationContextwerden.
Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen aufzulisten, die dem Präfix entsprechen, wobei der Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos dieses instance verwendet werden.
Verwenden Sie die TableRequestOptions , um Ausführungsoptionen wie das Timeout oder die Wiederholungsrichtlinie für den Vorgang außer Kraft zu setzen.
Parameters:
String
, die das Präfix enthält, das für zurückzugebende Tabellennamen übereinstimmen soll.
null
an, um die auf CloudTableClientdem angegebenen Anforderungsoptionen zu verwenden.
null
, um den Vorgangskontext sicher zu ignorieren.
Returns:
Iterable
Auflistung der Tabellennamen im Speicherkonto, die lazily abgerufen werden und dem angegebenen Präfix entsprechen.listTablesSegmented
public ResultSegment
Listet die Tabellennamen im segmentierten Modus im Speicherkonto auf. Mit dieser Methode kann die Auflistung von Tabellen fortgesetzt werden, nachdem ein Teilsatz von Ergebnissen zurückgegeben wurde, wobei die vom Server im ResultSegment<T> -Objekt zurückgegebenen Informationen verwendet werden.
Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen unter Verwendung des Tabellendienstendpunkts und der Anmeldeinformationen des Speicherkontos dieses instance aufzulisten.
Returns:
String
-Objekten, die Tabellennamen im Speicherkonto enthalten.Throws:
listTablesSegmented
public ResultSegment
Listet die Tabellennamen im Speicherkonto auf, die dem angegebenen Präfix im segmentierten Modus entsprechen. Mit dieser Methode kann die Auflistung von Tabellen fortgesetzt werden, nachdem ein Teilsatz von Ergebnissen zurückgegeben wurde, wobei die vom Server im ResultSegment<T> -Objekt zurückgegebenen Informationen verwendet werden.
Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen aufzulisten, die dem Präfix entsprechen, wobei der Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos dieses instance verwendet werden.
Parameters:
String
, die das Präfix enthält, das für zurückzugebende Tabellennamen übereinstimmen soll.
Returns:
String
-Objekten, die Tabellennamen enthalten, die dem Präfix im Speicherkonto entsprechen.Throws:
listTablesSegmented
public ResultSegment
Listet bis zum angegebenen Maximum der Tabellennamen im Speicherkonto auf, die dem angegebenen Präfix in einem fortsetzbaren Modus mit dem angegebenen ResultContinuation Fortsetzungstoken entsprechen, wobei die angegebenen TableRequestOptions und OperationContextverwendet werden. Mit dieser Methode kann das Auflisten von Tabellen fortgesetzt werden, nachdem eine Seite mit Ergebnissen zurückgegeben wurde, wobei informationen verwendet werden, die vom Server im ResultSegment<T> -Objekt zurückgegeben werden.
Diese Methode ruft die ABFRAGETABELLEN-REST-API auf, um die Tabellennamen auflisten zu können, die dem Präfix entsprechen, und verwendet dabei den Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos dieses instance.
Verwenden Sie , TableRequestOptions um Ausführungsoptionen wie das Timeout oder die Wiederholungsrichtlinie für den Vorgang zu überschreiben.
Parameters:
String
, die das Präfix enthält, das für zurückzugebende Tabellennamen übereinstimmen soll.
null
für den ersten Aufruf an. Rufen Sie die getContinuationToken() -Methode für das Ergebnis auf, um das Objekt abzurufen, das ResultContinuation im nächsten Aufruf verwendet werden soll, um die Abfrage fortzusetzen.
null
an, um die auf CloudTableClientdem angegebenen Anforderungsoptionen zu verwenden.
null
, um den Vorgangskontext sicher zu ignorieren.
Returns:
String
-Objekten, die Tabellennamen im Speicherkonto enthalten.Throws:
setDefaultRequestOptions
public void setDefaultRequestOptions(TableRequestOptions defaultRequestOptions)
Legt den fest, der TableRequestOptions für jede Tabelle verwendet wird, auf die mit diesem Objekt zugegriffen wird.
Parameters:
uploadServiceProperties
public void uploadServiceProperties(final ServiceProperties properties)
Lädt eine neue ServiceProperties Konfiguration in den angegebenen Speicherdienst hoch. Dazu gehören Protokollierung, HourMetrics, MinuteMetrics und CORS-Konfigurationen.
Parameters:
Throws:
uploadServiceProperties
public void uploadServiceProperties(final ServiceProperties properties, TableRequestOptions options, OperationContext opContext)
Lädt eine neue ServiceProperties Konfiguration in den angegebenen Speicherdienst hoch. Dazu gehören Protokollierung, HourMetrics, MinuteMetrics und CORS-Konfigurationen.
Parameters:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
Gilt für:
Azure SDK for Java