Funkce Náhled: požadavky Azure Cosmos DB for SQL API Data Provider

Toto téma popisuje požadavky na službu Azure Cosmos DB pro zprostředkovatele dat SQL rozhraní API a způsob konfigurace a doporučené postupy při použití služby Azure Cosmos DB pro zprostředkovatele dat SQL rozhraní API s virtuálními tabulkami.

Důležité

• Ukázkové funkce nejsou určené pro normální používání a mohou mít omezené fungování. Jsou to funkce, které jsou poskytnuté před svým oficiálním vydáním, aby si je zákazníci mohli co nejdříve vyzkoušet a mohli nám napsat své názory.
• V této funkci ještě asi uděláme změny, takže byste ji neměli používat pro normální práci. Je určená jenom pro účely testování a vývoje.
• Microsoft neposkytuje podporu pro tuto ukázkovou funkci. Technická podpora pro Microsoft Dynamics 365 vám s problémy nebo dotazy nepomůže. Ukázkové funkce nejsou určené pro normální používání a podléhají samostatným dodatečným podmínkám použití.

Co je Azure Cosmos DB?

Azure Cosmos DB je globálně distribuovaná databáze společnosti Microsoft pro nejdůležitější aplikace. Poskytuje bohaté a známé možnosti dotazů SQL s konzistentně nízkými čekacími dobami nad daty bez schématu JSON. Další informace: Úvod do Azure Cosmos DB: rozhraní SQL API

Požadavky

• Předplatné služby Azure, která obsahuje Azure Cosmos DB.
• Kolekce Azure Cosmos DB SQL API.
• Typ databáze Azure Cosmos DB by měl být SQL.

Mapování datového typu

Předpokládejme, že máte dokument Azure Cosmos DB v kolekci s názvem Objednávky, která má následující strukturu JSON.

Tato tabulka označuje mapování datového typu pro dokument SQL API v kolekci Objednávky v Microsoft Dataverse.

Data rozhraní API SQL	Dataverse
id	Primární klíč
name	Jeden řádek textu
quantity	Celé číslo
orderid	Jeden řádek textu
ordertype	Volba
amount	Desetinné číslo nebo měna
delivered	Ano/Ne
datetimeoffset	Datum a čas

Poznámka

• Rozraní API SQL generuje atributy s předponou s podtržítkem (_).
• Atributy, které jsou nakonfigurovány jako volitelné v dokumentu SQL API a jsou mapovány v Dataverse jako Požadováno podnikem, způsobí chybu za běhu.
• hodnoty atributu ID musí být GUID.
• Další informace o použití dat v rozhraní SQL API získáte v tématu Práce s daty v Azure Cosmos DB.

Podporované filtrování dotazů SQL

Filtrování dotazů SQL podporuje následující operátory.

• Operátory porovnání:<,>,<=, >=,!=
• Logické operátory: and, or
• Operátory SET: in, not in
• Operátory řetězce: like, contains, begins with, ends with

Poznámka

Použití operátoru like je přeloženo na odpovídající operátory contains/begins with/ends with. Rozhraní API SQL nepodporuje argumenty vzoru, jak je popsáno v tématu Like (Transact-SQL). Služba Azure Cosmos DB pro zprostředkovatele dat SQL rozhraní API může převést jediný speciální případ operátoru Like('[aA]%') na BeginsWith('a') OR BeginsWith('A'). Všimněte si, že porovnání řetězců v rozhraní API SQL rozlišuje velká a malá písmena.

Přidání zdroje dat při použití Azure Cosmos DB for SQL API Data Provider

1. Přejděte na AppSource, vyberte ZÍSKAT NYNÍ, a postupujte podle pokynů pro přidání aplikace do vašeho prostředí pomocí verze v9x nebo novější.

2. Po instalaci řešení se přihlaste k prostředí a přejděte na Nastavení > Správa > Virtuální zdroje dat entity..

3. Na panelu nástrojů Akce vyberte tlačítko NOVÉ a v dialogovém okně Výběr zprostředkovatele dat vyberte Azure Cosmos DB for SQL API Data Provider a vyberte tlačítko OK.

4. Zadejte následující informace a poté vyberte tlačítko ULOžIT A ZAVříT.

   Sloupec	Popis
   Jméno	Zadejte název, který popisuje zdroj dat.
   Název kolekce	Název databáze Azure Cosmos DB obsahující kolekci, kterou chcete mít na povrchu virtuální tabulky.
   Autorizační klíč	Primární nebo sekundární klíč pro účet Azure Cosmos DB. Můžete najít klíč z portálu pro správce služeb Azure v nastavení Klíče ve vašem účtu Azure Cosmos DB.
   Identifikátor URI	Identifikátor URI skupiny zdrojů, kde se kolekce Azure Cosmos DB nachází. Identifikátor URI je vytvořen podobně jako https://contoso/documents.azure.com:443. Můžete najít URI z portálu pro správce služeb Azure v nastavení Klíče pro váš účet Azure Cosmos DB.
   Časový limit v sekundách	Zadejte počet sekund čekání na odpověď ze služby Azure Cosmos DB před vypršením časového limitu žádosti o data. Zadejte například 30, aby se čekalo maximálně třicet sekund před vypršením časového limitu. Výchozí prodleva je 120 sekund.

   

Doporučené postupy a omezení

• Všimněte si následujícího při použití Azure Cosmos DB jako zdroj dat:
  • Každý zdroj dat Azure Cosmos DB lze přidružit pouze k jedné virtuální tabulce.
  • Můžete připojit více zdrojů dat ve stejné kolekci v Azure Cosmos DB.
• Nelze rozdělit data v kolekci podle tabulky.
• Databáze Azure Cosmos DB nevyžadují schéma, ale data v rámci Azure Cosmos DB musí být strukturována pomocí předvídatelného schématu.
• I když služba Azure Cosmos DB pro zprostředkovatele dat SQL rozhraní API implementuje překlad dotazu projekčních, filtrovacích a řadících operátorů, nepodporuje operace spojení.
• V rozhraní API SQL můžete filtrovat pouze podle jednoho sloupce.

Viz také

Vytvoření a úprava virtuálních tabulek, které obsahují data z externího zdroje dat

Poznámka

Můžete nám sdělit, jaké máte jazykové preference pro dokumentaci? Zúčastněte se krátkého průzkumu. (upozorňujeme, že tento průzkum je v angličtině)

Průzkum bude trvat asi sedm minut. Nejsou shromažďovány žádné osobní údaje (prohlášení o zásadách ochrany osobních údajů).